MCP Atlassian

MCP Atlassian

site icon
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 服务器,旨在提供高效的团队协作和项目管理工具。

核心功能

  1. Confluence 集成:支持搜索、创建、更新和删除 Confluence 页面,获取页面内容、子页面、父页面和评论等。
  2. Jira 集成:支持搜索、创建、更新和删除 Jira 问题,获取问题详情、项目问题、Epic 问题、工作日志和附件等。
  3. 多种部署支持:支持 Confluence 和 Jira 的云版本以及服务器/数据中心部署版本。
  4. 灵活的配置选项:支持通过命令行参数或环境变量进行配置,可以选择只使用 Confluence 或 Jira,或两者同时使用。
  5. 多种传输方式:支持 stdio(默认)和 sse 两种传输方式。

适用场景

  1. 团队协作:通过 Confluence 和 Jira 的集成,提高团队协作效率。
  2. 项目管理:通过 Jira 的工具集,方便地进行项目管理和问题跟踪。
  3. 知识管理:通过 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 问题

常见问题解答

  1. 如何获取 API 令牌?
  2. 对于云版本,访问 https://id.atlassian.com/manage-profile/security/api-tokens 创建 API 令牌。
  3. 对于服务器/数据中心版本,访问个人资料 → ProfilePersonal Access Tokens 创建令牌。
  4. 如何配置只使用 Confluence 或 Jira?
  5. 在命令行参数中只包含 Confluence 或 Jira 的相关参数即可。
  6. 如何调试?
  7. 使用 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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。