项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 6137
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已注册 Atlassian Cloud 账号(或自建 Server/Data Center 实例)
- 已安装可用的 uv 工具链,能使用 uvx 命令拉起 Python 包
- 一个支持 MCP 的客户端,如 Claude Desktop、Cursor、GitHub Copilot 或 Autohand Code
- Confluence、Jira 的站点地址与登录邮箱
安装与启动步骤
-
1创建 API 令牌
在浏览器打开 Atlassian 令牌页面创建 API Token 并立即复制保存;Server/Data Center 需改用个人访问令牌。
-
2准备 uvx 运行环境
配置中的启动命令是 uvx,需保证本机已安装 uv 且终端能直接调用 uvx,否则客户端无法拉起服务器。
-
3打开客户端 MCP 配置
在 Claude Desktop、Cursor 或 GitHub Copilot 的 MCP 配置文件中新增一个 mcpServers 条目。
-
4粘贴服务器配置
将 uvx 启动方式与六个环境变量按实际站点地址、邮箱、令牌替换后写入配置。
-
5重启客户端验证
保存配置后完全退出并重启客户端,让它重新加载 MCP 服务并建立连接。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
JIRA_URL | 是 | Jira 站点根地址,Cloud 版本为 xxx.atlassian.net | https://your-company.atlassian.net |
JIRA_USERNAME | 是 | Jira 登录邮箱,仅 Cloud 使用;Server/DC 请改用 JIRA_PERSONAL_TOKEN | your.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
同类项目推荐
lobehub
开源
把 AI 团队组织起来,7×24 小时自动干活
LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already···
dsh-crew
开源
在 Claude Code 里指挥 DSH 智能体干活,还能看图生图
DeepSeek Harness (DSH) plugin: dispatch work to DSH agents from Claude Code / Codex ···
Neo-MoFox
开源
让 AI 从聊天工具进化为有记忆的数字生命体
一个全新重构的 AI 聊天机器人框架,它的目标不仅仅是回答问题,而是创造一个真正的数字生···
developers-agent-toolkit
开源
让AI代理直接调用Mastercard支付服务,省去手动对接。
The Mastercard Developers Agent Toolkit allows popular agent frameworks to integrate···
deepseek-harness-studio
开源
零代码桌面端,一键装好 DeepSeek 智能体插件
DeepSeek Harness 零代码桌面端|一键启动,支持 Windows 与 macOS;内置插件发现、热点插···
dockershrink
开源
用 AI 自动瘦身 Docker 镜像,构建更小更快的应用
AI Assistant that reduces the size of your application's Docker Image
agentmako
开源
本地优先的 MCP 服务器,让 AI 编码代理秒懂你的代码库
Local-first MCP server that gives coding agents structured context packets, code/sch···
SkillNet
开源
像管理代码一样管理 AI 技能,一键评估、复用和编排。
Create, Evaluate, and Connect AI Skills
talkcody
开源
用大白话聊出代码,AI 帮你写、改、查
TalkCody - Code is cheap, show me your talk. Free Open Source AI Coding Agent.
