AI导哈

Atlassian工具协议服务器

企业级MCP服务器，为Jira、Confluence和Bitbucket提供102种生产就绪工具，支持本地或AWS Lambda部署，内置企业级安全功能。

  • by anthonyd23
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 anthonyd23/atlassian_mcp

使用说明

Atlassian MCP服务器

Atlassian工具（Jira、Confluence和Bitbucket）的模型上下文协议（MCP）服务器。

企业级MCP服务器为Jira、Confluence和Bitbucket提供102个生产就绪工具

  • ✨ 与Amazon Q Developer、Claude、Cursor等合作
  • 🚀 在本地部署或部署到AWS Lambda
  • 🔒 内置企业安全
  • 🎫 票务支持代理，配备6个专业工具

快速链接

快速开始

地方发展：

pip install -r mcp_server/requirements.txt
cp config.template.yaml config.yaml
# Edit config.yaml with your credentials
python mcp_server/main.py

配置示例：

云：

deployment_type: cloud
cloud:
  atlassian_base_url: https://yourcompany.atlassian.net
  atlassian_username: your-email@company.com
  atlassian_api_token: your-token
  bitbucket_workspace: your-workspace
  bitbucket_api_token: your-token

数据中心：

deployment_type: datacenter
datacenter:
  jira_base_url: https://jira.company.com
  jira_pat_token: your-token
  confluence_base_url: https://wiki.company.com
  confluence_pat_token: your-token
  bitbucket_base_url: https://git.company.com
  bitbucket_pat_token: your-token
  bitbucket_project: PROJECT_KEY

AWS部署：

cp config.template.yaml config.yaml
# Edit config.yaml with your credentials
python deploy.py

特性

  • Jira （31个工具）：问题、评论、转换、附件、附件上传、用户、工作日志、标签、问题链接、高级搜索、优先级管理、敏捷板、冲刺、用户权限
  • 汇流 （31个工具）：页面、空格、评论、附件、搜索、用户、按用户密钥查找用户、标签、页面历史、权限、页面复制、用户内容、最近内容、版本还原、按作者/标签搜索、页面层次结构（移动、子代、后代、祖先）、CQL搜索
  • 比特桶 （34个工具）：存储库、拉取请求、提交、分支、差异、文件搜索、审阅者、分支管理、PR活动、默认审阅者、作者筛选、更改请求、分支限制、构建状态、webhooks
  • 票务支持代理 （6个工具）：开放式工单分流、模板验证、受让人建议、团队工作量分析、专业知识JQL构建、故障排除文档查找
  • 灵活的凭证：仅配置所需的服务
  • 双平台：支持云和数据中心部署
  • AWS就绪：通过API网关部署为Lambda功能

先决条件

地方发展：

  • Python 3.11+
  • Atlassian帐户（云或数据中心）
  • 用于要使用的服务的API令牌

AWS部署（可选）：

生成令牌：

  • 云：https://id.atlassian.com/manage-profile/security/api-tokens
  • 比特桶云：https://bitbucket.org/account/settings/app-passwords/
  • 数据中心：简介→ 个人访问令牌

配置

AWS部署

  1. 复制模板：
cp config.template.yaml config.yaml
  1. 编辑 config.yaml 使用您的凭据：

对于云：

deployment_type: cloud
cloud:
  atlassian_base_url: https://yourcompany.atlassian.net
  atlassian_username: your-email@company.com
  atlassian_api_token: your-token
  bitbucket_workspace: your-workspace  # optional
  bitbucket_api_token: your-token      # optional

对于数据中心：

deployment_type: datacenter
datacenter:
  jira_base_url: https://jira.company.com
  jira_pat_token: your-token
  confluence_base_url: https://wiki.company.com
  confluence_pat_token: your-token
  bitbucket_base_url: https://git.company.com
  bitbucket_pat_token: your-token
  bitbucket_project: PROJECT_KEY
  1. 部署：
python deploy.py

本地开发

对于当地发展，使用 config.yaml （格式与AWS部署相同）：

cp config.template.yaml config.yaml
# Edit config.yaml with your credentials and optional ticket support agent config
python mcp_server/main.py

备注：服务器从以下位置加载配置 config.yaml 自动。如果满足以下条件，则可以使用环境变量作为替代 config.yaml 不存在，但正在使用 config.yaml 是与AWS部署保持一致的推荐方法。

平台检测：服务器会自动检测是按以下顺序使用云API还是数据中心API：

  1. DEPLOYMENT_TYPE 环境变量(cloud 或 datacenter)
  2. deployment_type 领域 config.yaml
  3. 数据中心凭据（PAT令牌）的存在
  4. 如果以上都没有，则默认为Cloud

AI代理集成

与流行的AI代理和开发工具集成：

亚马逊Q开发者：

{
  "mcpServers": {
    "atlassian-mcp": {
      "command": "python",
      "args": ["/absolute/path/to/mcp_server/main.py"],
      "env": {
        "ATLASSIAN_BASE_URL": "https://yourcompany.atlassian.net",
        "ATLASSIAN_USERNAME": "your-email@company.com",
        "ATLASSIAN_API_TOKEN": "your-token"
      }
    }
  }
}

还支持： 克劳德桌面，Cline（VS代码），光标，继续，Zed编辑器

看 AGENT_INTEGRATION.md 有关完整的设置说明。

AWS部署

  1. 配置凭据：
cp config.template.yaml config.yaml
# Edit config.yaml with your Atlassian credentials
  1. 部署：
python deploy.py

脚本将：

  • 构建SAM应用程序
  • 使用您的凭据部署到AWS
  • 显示MCP API URL

看 部署_ GIDE.md 详细说明。

测试

单元测试：

pip install -r requirements-dev.txt
pytest tests/unit/

集成测试：

云（使用真实凭据进行测试）：

python tests/cloud/test_all_cloud_tools.py

数据中心（使用真实凭证进行测试）：

python tests/datacenter/test_all_dc_tools.py

通用/代理工具（具有真实凭据的测试）：

python tests/common/test_all_common_tools.py

测试特点：

  • 全面的单元测试覆盖率
  • 核心工作流程的集成测试
  • 显示结果的详细输出

监控

CloudWatch与以下设备集成：

  • 结构化JSON日志记录
  • 自定义指标（工具使用、持续时间）
  • 自动报警（错误、节流、响应缓慢）
  • 可视化仪表板

看 监测.md 用于设置和配置。

文档

API文档

安全

  • 同一帐户访问的IAM身份验证
  • 速率限制（100请求/秒，200突发）
  • Lambda环境变量中的加密凭据
  • 仅HTTPS流量
  • config.yaml gitignored（凭据不在版本控制中）

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

相关 MCP