Atlassian MCP (Dawid Adamski)

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构建上下文中。