
MCP Atlassian

2025.04.18
972
Python团队协作项目管理知识管理交流协作
MCP Atlassian 是一个 Model Context Protocol (MCP) 服务器,专门用于与 Atlassian 产品(Confluence 和 Jira)进行集成。该服务支持 Confluence 和 Jira 的云版本以及服务器/数据中心部署版本。通过提供丰富的工具集,用户可以方便地搜索、创建、更新和删除 Confluence 页面和 Jira 问题,从而提高团队协作和项目管理效率。
View on GitHub
Overview
基本能力
产品定位
MCP Atlassian 是一个专门用于与 Atlassian 产品(Confluence 和 Jira)集成的 MCP 服务器,旨在提供高效的团队协作和项目管理工具。
核心功能
- Confluence 集成:支持搜索、创建、更新和删除 Confluence 页面,获取页面内容、子页面、父页面和评论等。
- Jira 集成:支持搜索、创建、更新和删除 Jira 问题,获取问题详情、项目问题、Epic 问题、工作日志和附件等。
- 多种部署支持:支持 Confluence 和 Jira 的云版本以及服务器/数据中心部署版本。
- 灵活的配置选项:支持通过命令行参数或环境变量进行配置,可以选择只使用 Confluence 或 Jira,或两者同时使用。
- 多种传输方式:支持
stdio
(默认)和sse
两种传输方式。
适用场景
- 团队协作:通过 Confluence 和 Jira 的集成,提高团队协作效率。
- 项目管理:通过 Jira 的工具集,方便地进行项目管理和问题跟踪。
- 知识管理:通过 Confluence 的工具集,方便地进行知识管理和文档编写。
工具列表
工具 | 描述 |
---|---|
confluence_search |
使用 CQL 搜索 Confluence 内容 |
confluence_get_page |
获取特定 Confluence 页面的内容 |
confluence_get_page_children |
获取特定 Confluence 页面的子页面 |
confluence_get_page_ancestors |
获取特定 Confluence 页面的父页面 |
confluence_get_comments |
获取特定 Confluence 页面的评论 |
confluence_create_page |
创建新的 Confluence 页面 |
confluence_update_page |
更新现有的 Confluence 页面 |
confluence_delete_page |
删除现有的 Confluence 页面 |
confluence_attach_content |
将内容附加到 Confluence 页面 |
jira_get_issue |
获取特定 Jira 问题的详情 |
jira_search |
使用 JQL 搜索 Jira 问题 |
jira_get_project_issues |
获取特定 Jira 项目的所有问题 |
jira_get_epic_issues |
获取与特定 Epic 链接的所有问题 |
jira_create_issue |
在 Jira 中创建新问题 |
jira_update_issue |
更新现有的 Jira 问题 |
jira_delete_issue |
删除现有的 Jira 问题 |
jira_get_transitions |
获取 Jira 问题的可用状态转换 |
jira_transition_issue |
将 Jira 问题转换到新状态 |
jira_add_comment |
向 Jira 问题添加评论 |
jira_add_worklog |
向 Jira 问题添加工作日志条目 |
jira_get_worklog |
获取 Jira 问题的工作日志条目 |
jira_download_attachments |
从 Jira 问题下载附件 |
jira_link_to_epic |
将问题链接到 Epic |
jira_get_agile_boards |
按名称、项目键或类型获取 Jira 敏捷板 |
jira_get_board_issues |
获取与特定板链接的所有问题 |
jira_get_sprints_from_board |
按状态从板获取 Jira 冲刺 |
jira_get_sprint_issues |
从冲刺获取 Jira 问题 |
常见问题解答
- 如何获取 API 令牌?
- 对于云版本,访问 https://id.atlassian.com/manage-profile/security/api-tokens 创建 API 令牌。
- 对于服务器/数据中心版本,访问个人资料 → Profile → Personal Access Tokens 创建令牌。
- 如何配置只使用 Confluence 或 Jira?
- 在命令行参数中只包含 Confluence 或 Jira 的相关参数即可。
- 如何调试?
- 使用
npx @modelcontextprotocol/inspector
工具进行调试,或查看日志文件~/Library/Logs/Claude/mcp*.log
。
使用教程
使用依赖
无特殊依赖,直接安装即可。
安装教程
选择以下一种安装方法:
# 使用 uv(推荐)
brew install uv
uvx mcp-atlassian
# 使用 pip
pip install mcp-atlassian
# 使用 Docker
git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .
# 使用 Smithery
npx -y @smithery/cli install mcp-atlassian --client claude
调试方式
# 使用 MCP Inspector
# 对于已安装的包
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...
# 对于本地开发版本
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...
# 查看日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log