MCP Atlassian - Atlassian 产品模型上下文协议服务

---

一、项目概览

为 Atlassian 产品（Confluence 和 Jira）提供模型上下文协议（MCP）服务，支持 Confluence 和 Jira 的云版本及 Server/Data Center 部署。

---

相关资源

• 源码：https://github.com/sooperset/mcp-atlassian
• PyPI 版本：https://img.shields.io/pypi/v/mcp-atlassian
• 下载量统计：https://img.shields.io/pypi/dm/mcp-atlassian | https://static.pepy.tech/personalized-badge/mcp-atlassian
• 测试状态：https://github.com/sooperset/mcp-atlassian/actions/workflows/tests.yml/badge.svg
• 许可证：https://img.shields.io/github/license/sooperset/mcp-atlassian

---

二、核心特性

1、自动化 Jira 更新

• 通过 AI 助手自动从会议记录更新 Jira 任务
• 示例指令：“Update Jira from our meeting notes”

2、智能 Confluence 搜索

• 基于 AI 的内容检索与摘要生成
• 示例指令：“Find our OKR guide in Confluence and summarize it”

3、高级 Jira 问题筛选

• 支持时间范围和优先级的多维度过滤
• 示例指令：“Show me urgent bugs in PROJ project from last week”

4、内容创作管理

• 自动化技术文档生成
• 示例指令：“Create a tech design doc for XYZ feature”

---

三、兼容性支持

产品	部署类型	支持状态
Confluence	Cloud	✅ 完全支持
Confluence	Server/Data Center	✅ 支持(v6.0+)
Jira	Cloud	✅ 完全支持
Jira	Server/Data Center	✅ 支持(v8.14+)

---

四、快速开始

---

1、认证配置

云版本配置

1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
2. 创建并命名 API Token
3. 立即复制生成的 Token

本地部署配置

1. 进入个人资料 → Personal Access Tokens
2. 创建带过期时间的 Token
3. 立即复制生成的 Token

---

2、安装部署

推荐使用 Docker 方式运行：

# 拉取预构建镜像
docker pull ghcr.io/sooperset/mcp-atlassian:latest

---

五、IDE 集成配置

支持通过 JSON 配置文件与主流 IDE 集成：

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}

---

六、核心工具集

Confluence 工具

• confluence_search: 使用 CQL 搜索内容
• confluence_get_page: 获取特定页面内容
• confluence_create_page: 创建新页面
• confluence_update_page: 更新现有页面

Jira 工具

• jira_get_issue: 获取问题详情
• jira_search: 使用 JQL 搜索问题
• jira_create_issue: 创建新问题
• jira_update_issue: 更新现有问题

---

七、安全说明

• API Token 需严格保密
• 生产环境禁用 SSL 验证需谨慎
• 详细安全规范见 SECURITY.md

伊织 xAI 2025-05-03（六）