mcp-atlassian

让 AI 直接读写 Jira 和 Confluence

开源 🏷️基础免费,高级付费 ⏳ 访问状态待核验 智能体 🍴 复刻 1461 🐛 待处理 251 👀 关注 21
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 6137
维护状态 活跃
是否开源 开源
定价模式 🏷️基础免费,高级付费 支持限时试用 · 开源免费,另有云托管付费版,定价信息待确认

项目预览

mcp-atlassian 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队sooperset
定价模式🏷️基础免费,高级付费
价格说明开源免费,另有云托管付费版,定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议MIT
主要语言Python
技术栈/模型atlassian,confluence,jira,mcp
GitHub 星标★ 6137
上线时间2024-12-03 00:00:00
代码更新2026-11-16
仓库体积6.2 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

mcp-atlassian 是一个基于 Python 的 MCP(Model Context Protocol)服务器,把 Atlassian 生态中的 Confluence 和 Jira 接入支持 MCP 的 AI 客户端与智能体。它解决的是大模型无法直接读取和操作企业知识库、工单系统的问题:通过统一协议把 Confluence 页面、空间、搜索能力,以及 Jira 项目、Issue、评论、状态流转等封装成模型可调用的工具。核心能力包括按关键词或 CQL/JQL 检索内容、读取页面与工单详情、创建和更新 Issue、添加评论、查询项目与用户信息,并支持云端与 Server/Data Center 两种部署形态的认证配置。项目以容器和本地进程方式运行,配置好站点地址与 API Token 后即可被 Claude Desktop、IDE 助手等 MCP 客户端加载,让智能体在企业内部文档与项目管理数据上完成问答、汇总和自动化操作,减少人工在多个系统间切换的成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 6137

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

环境要求

  • 已注册 Atlassian Cloud 账号(或自建 Server/Data Center 实例)
  • 已安装可用的 uv 工具链,能使用 uvx 命令拉起 Python 包
  • 一个支持 MCP 的客户端,如 Claude Desktop、Cursor、GitHub Copilot 或 Autohand Code
  • Confluence、Jira 的站点地址与登录邮箱

安装与启动步骤

  1. 1创建 API 令牌

    在浏览器打开 Atlassian 令牌页面创建 API Token 并立即复制保存;Server/Data Center 需改用个人访问令牌。

  2. 2准备 uvx 运行环境

    配置中的启动命令是 uvx,需保证本机已安装 uv 且终端能直接调用 uvx,否则客户端无法拉起服务器。

  3. 3打开客户端 MCP 配置

    在 Claude Desktop、Cursor 或 GitHub Copilot 的 MCP 配置文件中新增一个 mcpServers 条目。

  4. 4粘贴服务器配置

    将 uvx 启动方式与六个环境变量按实际站点地址、邮箱、令牌替换后写入配置。

  5. 5重启客户端验证

    保存配置后完全退出并重启客户端,让它重新加载 MCP 服务并建立连接。

关键配置

配置项必填说明示例
JIRA_URL是Jira 站点根地址,Cloud 版本为 xxx.atlassian.nethttps://your-company.atlassian.net
JIRA_USERNAME是Jira 登录邮箱,仅 Cloud 使用;Server/DC 请改用 JIRA_PERSONAL_TOKENyour.email@company.com
JIRA_API_TOKEN是上一步创建的 API 令牌,用于 Jira 接口鉴权your_api_token
CONFLUENCE_URL是Confluence 站点地址,Cloud 版本需带 /wiki 路径https://your-company.atlassian.net/wiki
CONFLUENCE_USERNAME是Confluence 登录邮箱,仅 Cloud 使用your.email@company.com
CONFLUENCE_API_TOKEN是Confluence 接口鉴权用的 API 令牌,可与 Jira 共用同一个your_api_token

如何确认成功

重启客户端后,在 MCP 工具列表中能看到 mcp-atlassian 提供的 Confluence 页面检索与 Jira 工单相关工具,即表示连接成功。

常见问题

Q:Server/Data Center 版本怎么填认证信息?

A:不要填用户名加 API Token,改用 JIRA_PERSONAL_TOKEN 提供个人访问令牌,Confluence 侧同理替换对应令牌字段。

Q:Confluence 地址为什么必须带 /wiki?

A:Cloud 版 Confluence 挂在站点域名的 /wiki 路径下,缺少该后缀会导致接口请求 404。

Q:客户端里看不到任何工具怎么办?

A:先确认 uvx 命令本身可执行,再检查配置里的环境变量是否填全,最后重启客户端重新加载配置。

Q:同一个令牌能同时给 Jira 和 Confluence 用吗?

A:可以。示例配置中两个 API_TOKEN 填同一个值即可,令牌对同一 Atlassian 站点通用。

注意事项

  • API Token 属于敏感凭据,不要提交到代码仓库或公开分享。
  • 配置中的站点地址、邮箱需替换成自己的真实信息,否则服务启动后调用会失败。
  • 修改 MCP 配置后必须重启客户端才会生效。

核心亮点

  • 同时覆盖 Confluence 与 Jira,工具集较完整,检索、读写、评论、状态流转都有对应能力
  • 基于 MCP 标准协议,可被多种 AI 客户端和智能体框架直接加载,接入成本低
  • 支持云端与 Server/Data Center 两种部署及多种认证方式,适配企业内不同版本环境

不足之处

  • 依赖 Atlassian API 权限配置,Token 或权限不足时部分工具会失败,排错门槛偏高
  • 工具数量较多,全部暴露给模型时上下文占用大,需要按场景裁剪
  • 文档与社区仍在成长,复杂企业权限模型下的最佳实践沉淀有限

适用场景

  • 让 AI 助手根据 JQL 汇总本周 Jira 缺陷并生成周报
  • 在 Confluence 中检索产品文档,回答团队内部知识问题
  • 通过智能体自动创建 Issue、补充评论并更新工单状态

替代项目

atlassian-python-api、jira-mcp、confluence-mcp

上一篇:ida-pro-mcp

下一篇:awesome-remote-mcp-servers

同类项目推荐

lobehub 开源

把 AI 团队组织起来,7×24 小时自动干活

LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already···

★ 85769 2026-08-09
dsh-crew 开源

在 Claude Code 里指挥 DSH 智能体干活,还能看图生图

DeepSeek Harness (DSH) plugin: dispatch work to DSH agents from Claude Code / Codex ···

★ 217 2026-09-16
Neo-MoFox 开源

让 AI 从聊天工具进化为有记忆的数字生命体

一个全新重构的 AI 聊天机器人框架,它的目标不仅仅是回答问题,而是创造一个真正的数字生···

★ 132 2026-08-09
developers-agent-toolkit 开源

让AI代理直接调用Mastercard支付服务,省去手动对接。

The Mastercard Developers Agent Toolkit allows popular agent frameworks to integrate···

★ 60 2026-08-09
deepseek-harness-studio 开源

零代码桌面端,一键装好 DeepSeek 智能体插件

DeepSeek Harness 零代码桌面端|一键启动,支持 Windows 与 macOS;内置插件发现、热点插···

★ 728 2026-09-25
dockershrink 开源

用 AI 自动瘦身 Docker 镜像,构建更小更快的应用

AI Assistant that reduces the size of your application's Docker Image

★ 417 2026-08-09
agentmako 开源

本地优先的 MCP 服务器,让 AI 编码代理秒懂你的代码库

Local-first MCP server that gives coding agents structured context packets, code/sch···

★ 54 2026-08-09
SkillNet 开源

像管理代码一样管理 AI 技能,一键评估、复用和编排。

Create, Evaluate, and Connect AI Skills

★ 1454 2026-08-09
talkcody 开源

用大白话聊出代码,AI 帮你写、改、查

TalkCody - Code is cheap, show me your talk. Free Open Source AI Coding Agent.

★ 480 2026-08-09