MCP 服务器

MCP-DOCKER-Atlassian

使用 Docker 运行 MCP 服务器并连接到 Atlassian。 (Shǐyòng Docker yùnxíng MCP fúwùqì bìng liánjiē dào Atlassian.) This translates to: "Run an MCP server using Docker and connect to Atlassian."

shane-reaume

开发者工具

访问服务器

README

MCP-DOCKER-Atlassian

基于 Docker 的 MCP Atlassian 集成设置，用于 VS Code 的 Copilot MCP 扩展。

此仓库包含配置和脚本，可轻松在 Docker 容器中运行 MCP Atlassian 服务器，从而通过模型上下文协议访问 Confluence 和 Jira 资源。

注意： 之前从上游项目继承的 MyPy 类型检查问题已得到解决。类型检查系统现在可以完全正常工作并通过所有检查。

前提条件

已安装并运行 Docker
带有 Copilot Chat 扩展的 Visual Studio Code
具有 API 令牌的 Atlassian Cloud 帐户
- 在以下位置生成令牌：https://id.atlassian.net/manage-profile/security/api-tokens
- 安全地保存令牌 - 创建后无法再次查看

快速开始

克隆仓库：

git clone https://github.com/shane-reaume/MCP-DOCKER-Atlassian.git
cd MCP-DOCKER-Atlassian

设置您的凭据： 复制示例环境变量文件并进行编辑：
```
cp .env.example .env
# 使用您的 Atlassian 凭据编辑 .env
```
重要提示：请勿在 .env 文件中的值周围使用引号
使脚本可执行：
```
chmod +x *.sh
```
启动 MCP 服务器：
```
./start-mcp.sh
```
服务器将在 http://localhost:9001/sse 上可用 停止 MCP 服务器：
```
./stop-mcp.sh
```

配置 VS Code： 将此添加到您的 VS Code settings.json：

"mcpManager.servers": [
  {
    "name": "Atlassian-MCP",
    "type": "sse",
    "url": "http://localhost:9001/sse",
    "enabled": true
  }
]

完成后停止服务器：
```
./stop-mcp.sh
```

可用脚本

start-mcp.sh: 构建 Docker 镜像并启动容器
stop-mcp.sh: 停止正在运行的容器
check-mcp.sh: 诊断工具，用于验证服务器是否正常运行
cleanup.sh: 删除旧容器和镜像
update-remote.sh: 用于管理 git 远程的助手
mcp-manager.sh: 其他管理命令

可用的 MCP 命令

连接后，您可以使用以下命令：

@mcp confluence_search "搜索词"
@mcp confluence_get_page "页面标题"
@mcp jira_get_issue "PROJECT-123"
@mcp jira_search "project = PROJECT AND status = 'In Progress'"

故障排除

SSE 连接问题
- 确保 Docker 容器正在运行：docker ps | grep mcp-atlassian
- 检查容器日志：docker logs mcp-atlassian
- 验证端口是否可访问：curl http://localhost:9001/health
身份验证问题
- 确保您的 API 令牌正确，并且在 .env 中没有被引号包围
- 检查您的电子邮件是否与用于生成 API 令牌的电子邮件匹配
- 验证您在 Confluence/Jira 中是否具有适当的权限
常见错误
- "SSE error: TypeError: fetch failed": 重新启动 VS Code 和 MCP 服务器
- "Current user not permitted": 检查 API 令牌和权限
- 空结果：验证空间/项目访问权限，并首先尝试更一般的搜索