AI导哈

Atlassian产品MCP服务器

基于Python和uv构建的Atlassian产品专用MCP服务器，支持Jira、JSM、Confluence和Bitbucket等产品的模块化服务部署。

  • by DawidAdamski
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 DawidAdamski/AtlassianMCP

使用说明

Atlassian MCP

使用Python和.NET构建的Atlassian产品的MCP服务器 uv.

此存储库是根据签出的内容构建的 python-sdk 和 atlassian-python-api 此目录中的源代码树。 uvDocker和GitHub Actions被配置为使用相同的本地源，因此开发和发布的映像可以在一个一致的SDK组合上运行。

范围

此存储库公开了多个小型MCP服务器，而不是一个超大的服务器：

  • atlassian-mcp-jira
  • atlassian-mcp-jsm
  • atlassian-mcp-confluence
  • atlassian-mcp-bitbucket

目标是使每台服务器都保持在 6-10 工具范围，因此客户只能启用他们需要的产品表面。

安装

uv venv
uv pip install -e .

跑

默认传输方式为 stdio.

uv run atlassian-mcp-jira
uv run atlassian-mcp-jsm
uv run atlassian-mcp-confluence
uv run atlassian-mcp-bitbucket

要公开HTTP传输，请执行以下操作：

uv run atlassian-mcp-jira --transport streamable-http --port 8000

配置

每台服务器都使用特定于产品的环境变量：

  • 吉拉： ATLASSIAN_JIRA_*
  • JSM： ATLASSIAN_JSM_*
  • 汇流： ATLASSIAN_CONFLUENCE_*
  • 比特桶： ATLASSIAN_BITBUCKET_*

每个产品的共享变量名：

  • URL
  • USERNAME
  • PASSWORD
  • TOKEN
  • CLOUD
  • VERIFY_SSL
  • TIMEOUT

身份验证规则：

  • 对于Jira Cloud，更喜欢 USERNAME + PASSWORD，在哪里 PASSWORD 是您的Atlassian API令牌。
  • 使用 TOKEN 仅适用于需要承载令牌身份验证的产品和部署。
  • TOKEN 或 USERNAME + PASSWORD 必须设置。

例子：

$env:ATLASSIAN_JIRA_URL="https://your-site.atlassian.net"
$env:ATLASSIAN_JIRA_USERNAME="you@example.com"
$env:ATLASSIAN_JIRA_PASSWORD="your-api-token"
$env:ATLASSIAN_JIRA_CLOUD="true"
uv run atlassian-mcp-jira

文档

工具文档由MCP工具模式生成：

uv run atlassian-mcp-export-docs

生成的文件将写入 docs/generated/.

码头工人

本地构建：

docker build -t atlassian-mcp .

通过流式HTTP运行Jira服务器：

docker run --rm -p 8000:8000 `
  -e MCP_SERVER=jira `
  -e MCP_TRANSPORT=streamable-http `
  -e MCP_JSON_RESPONSE=true `
  -e ATLASSIAN_JIRA_URL="https://your-site.atlassian.net" `
  -e ATLASSIAN_JIRA_USERNAME="you@example.com" `
  -e ATLASSIAN_JIRA_PASSWORD="your-api-token" `
  -e ATLASSIAN_JIRA_CLOUD=true `
  atlassian-mcp

支持 MCP_SERVER 值：

  • jira
  • jsm
  • confluence
  • bitbucket

GitHub Actions工作流程 .github/workflows/docker.yml 根据拉取请求构建映像，并在 main 以及版本标签。 它也检查 modelcontextprotocol/python-sdk 和 atlassian-api/atlassian-python-api 在构建之前，先将其放入Docker构建上下文中。

相关 MCP