sooperset/mcp-atlassian
GitHub: sooperset/mcp-atlassian
为 AI 助手提供 Jira 和 Confluence 操作能力的 MCP 服务器，支持自然语言管理项目工单和企业知识库。
Stars: 4439 | Forks: 964
# MCP Atlassian
[](https://github.com/sooperset/mcp-atlassian/actions/workflows/tests.yml)
[](https://mcp-atlassian.soomiles.com)
用于 Atlassian 产品 (Confluence 和 Jira) 的 Model Context Protocol (MCP) 服务器。支持 Cloud 和 Server/Data Center 部署模式。
https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
## 快速开始
### 1. 获取您的 API Token
访问 https://id.atlassian.com/manage-profile/security/api-tokens 并创建一个 token。
### 2. 配置您的 IDE
将其添加到您的 Claude Desktop 或 Cursor MCP 配置中：
```
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"JIRA_URL": "https://your-company.atlassian.net",
"JIRA_USERNAME": "your.email@company.com",
"JIRA_API_TOKEN": "your_api_token",
"CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
"CONFLUENCE_USERNAME": "your.email@company.com",
"CONFLUENCE_API_TOKEN": "your_api_token"
}
}
}
}
```
### 3. 开始使用
让您的 AI 助手执行以下操作：
- **"在 PROJ 项目中查找分配给我的问题"**
- **"在 Confluence 中搜索入职文档"**
- **"为登录问题创建一个 Bug 工单"**
- **"将 PROJ-123 的状态更新为 Done"**
## 文档
完整文档请访问 **[mcp-atlassian.soomiles.com](https://mcp-atlassian.soomiles.com)**。
文档也提供 [llms.txt 格式](https://llmstxt.org/)，便于 LLM 直接读取：
- [`llms.txt`](https://mcp-atlassian.soomiles.com/llms.txt) — 文档站点地图
- [`llms-full.txt`](https://mcp-atlassian.soomiles.com/llms-full.txt) — 完整文档
| 主题 | 描述 |
|-------|-------------|
| [安装说明](https://mcp-atlassian.soomiles.com/docs/installation) | uvx, Docker, pip, 源码安装 |
| [身份验证](https://mcp-atlassian.soomiles.com/docs/authentication) | API tokens, PAT, OAuth 2.0 |
| [配置说明](https://mcp-atlassian.soomiles.com/docs/configuration) | IDE 设置, 环境变量 |
| [HTTP Transport](https://mcp-atlassian.soomiles.com/docs/http-transport) | SSE, streamable-http, 多用户 |
| [工具参考](https://mcp-atlassian.soomiles.com/docs/tools-reference) | 所有 Jira & Confluence 工具 |
| [故障排除](https://mcp-atlassian.soomiles.com/docs/troubleshooting) | 常见问题 & 调试 |
## 兼容性
| 产品 | 部署模式 | 支持情况 |
|---------|------------|---------|
| Confluence | Cloud | 完全支持 |
| Confluence | Server/Data Center | 支持 (v6.0+) |
| Jira | Cloud | 完全支持 |
| Jira | Server/Data Center | 支持 (v8.14+) |
## 主要工具
| Jira | Confluence |
|------|------------|
| `jira_search` - 使用 JQL 搜索 | `confluence_search` - 使用 CQL 搜索 |
| `jira_get_issue` - 获取问题详情 | `confluence_get_page` - 获取页面内容 |
| `jira_create_issue` - 创建问题 | `confluence_create_page` - 创建页面 |
| `jira_update_issue` - 更新问题 | `confluence_update_page` - 更新页面 |
| `jira_transition_issue` - 更改状态 | `confluence_add_comment` - 添加评论 |
**共 72 个工具** — 完整列表请参阅 [工具参考](https://mcp-atlassian.soomiles.com/docs/tools-reference)。
## 安全
切勿分享 API tokens。请妥善保管 `.env` 文件。详见 [SECURITY.md](SECURITY.md)。
## 贡献
开发设置请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
MIT - 详见 [LICENSE](LICENSE)。非 Atlassian 官方产品。
Confluence Demo
https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785标签：AI助手, API集成, Atlassian, Claude Desktop, Cloud, Confluence, Cursor, Data Center, Jira, Linux 内核安全, LLM工具, MCP, Model Context Protocol, Python, Ruby, 中间件, 企业协作, 可观测性, 工单系统, 效能工具, 无后门, 服务器, 知识库, 网络研究, 网络调试, 自动化, 请求拦截, 软件开发, 逆向工具, 项目管理