MCP-DOCKER-Atlassian

基本能力

产品定位

MCP-DOCKER-Atlassian 是一个为开发者和团队设计的工具，用于在 VS Code 环境中无缝集成 Atlassian 的 Confluence 和 Jira 服务，提升开发协作效率。

核心功能

1. Docker 容器化部署：提供一键式 Docker 容器启动和停止脚本，简化部署流程。
2. Atlassian 集成：支持通过 MCP 协议访问 Confluence 和 Jira 资源。
3. VS Code 扩展支持：与 VS Code 的 Copilot Chat 扩展无缝集成，提供便捷的命令交互。
4. 脚本管理：提供多个脚本用于启动、停止、诊断和管理服务。

适用场景

1. 开发协作：在开发过程中快速访问 Confluence 文档和 Jira 任务。
2. 项目管理：通过命令行快速查询和更新 Jira 任务状态。
3. 文档检索：在 VS Code 中直接搜索和获取 Confluence 页面内容。

工具列表

1. start-mcp.sh：构建 Docker 镜像并启动容器。
2. stop-mcp.sh：停止运行中的容器。
3. check-mcp.sh：诊断工具，用于验证服务器是否正常运行。
4. cleanup.sh：清理旧的容器和镜像。
5. update-remote.sh：管理 git 远程仓库的辅助工具。
6. mcp-manager.sh：提供额外的管理命令。

常见问题解答

1. SSE 连接问题：
2. 确保 Docker 容器正在运行：docker ps | grep mcp-atlassian
3. 检查容器日志：docker logs mcp-atlassian
4. 验证端口是否可访问：curl http://localhost:9001/health
5. 认证问题：
6. 确保 API 令牌正确且未在 .env 文件中用引号包围。
7. 检查用于生成 API 令牌的邮箱是否匹配。
8. 验证在 Confluence/Jira 中是否有适当的权限。
9. 常见错误：
10. "SSE error: TypeError: fetch failed"：重启 VS Code 和 MCP 服务器。
11. "Current user not permitted"：检查 API 令牌和权限。
12. 空结果：验证空间/项目访问权限，并尝试更通用的搜索。

使用教程

使用依赖

1. 安装并运行 Docker。
2. 安装 Visual Studio Code 及 Copilot Chat 扩展。
3. 拥有 Atlassian Cloud 账户并生成 API 令牌：
4. 生成令牌地址：https://id.atlassian.net/manage-profile/security/api-tokens
5. 安全保存令牌，生成后无法再次查看。

安装教程

1. 克隆仓库： bash git clone https://github.com/shane-reaume/MCP-DOCKER-Atlassian.git cd MCP-DOCKER-Atlassian
2. 设置凭证： bash cp .env.example .env # 编辑 .env 文件，填入 Atlassian 凭证 注意：不要在 .env 文件中的值周围使用引号。
3. 使脚本可执行： bash chmod +x *.sh
4. 启动 MCP 服务器： bash ./start-mcp.sh 服务器将在 http://localhost:9001/sse 可用。
5. 停止 MCP 服务器： bash ./stop-mcp.sh
6. 配置 VS Code： 在 VS Code 的 settings.json 中添加： json "mcpManager.servers": [ { "name": "Atlassian-MCP", "type": "sse", "url": "http://localhost:9001/sse", "enabled": true } ]

调试方式

1. 验证容器运行状态： bash docker ps | grep mcp-atlassian
2. 查看容器日志： bash docker logs mcp-atlassian
3. 检查健康状态： bash curl http://localhost:9001/health

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。