MCP DOCKER Atlassian

🚀 MCP-DOCKER-Atlassian 中文文檔

本項目提供了基於 Docker 的 Atlassian 集成設置，可與 VS Code 的 Copilot MCP 擴展配合使用。通過此倉庫中的配置和腳本，能輕鬆在 Docker 容器中運行 MCP Atlassian 服務器，藉助 Model Context Protocol 訪問 Confluence 和 Jira 資源。

⚠️ 重要提示

從上游項目繼承的 MyPy 類型檢查問題已解決。類型檢查系統現已完全正常工作，並且所有檢查均通過。

🚀 快速開始

克隆倉庫

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

設置憑證

複製示例環境文件並編輯：

cp .env.example .env
# 編輯 .env 文件以輸入你的 Atlassian 憑證

⚠️ 重要提示

請不要在 .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

✨ 主要特性

本項目提供了一系列腳本，方便用戶對 MCP 服務器進行管理：

• start-mcp.sh：構建 Docker 鏡像並啟動容器
• stop-mcp.sh：停止運行中的容器
• check-mcp.sh：診斷工具，用於驗證服務器是否正常運行
• cleanup.sh：移除舊的容器和鏡像
• update-remote.sh：幫助管理 Git 遠程倉庫
• mcp-manager.sh：其他管理命令

💻 使用示例

基礎用法

連接後，你可以使用以下命令：

@mcp confluence_search "搜索詞"
@mcp confluence_get_page "頁面標題"
@mcp jira_get_issue "PROJECT-123"
@mcp jira_search "project = PROJECT AND status = '進行中'"

🔧 技術細節

先決條件

• Docker 已安裝並運行
• Visual Studio Code 安裝了 Copilot Chat 擴展
• Atlassian 雲賬戶及 API 令牌
  • 在 https://id.atlassian.net/manage-profile/security/api-tokens 生成令牌
  • 安全保存令牌，創建後無法再次查看

環境變量

MCP 服務器通過以下環境變量進行配置：

📚 詳細文檔

故障排除

啟動問題

• 確保 Docker 已正確安裝並運行
• 檢查是否有足夠的權限執行腳本
• 查看輸出日誌以獲取更多信息

連接問題

• 確認服務器已成功啟動並在指定地址運行
• 檢查網絡配置，確保沒有防火牆阻止訪問
• 驗證 .env 文件中的配置是否正確無誤

基於資源

此項目基於以下資源和庫：

• 官方 MCP 文檔
• Docker 官方文檔
• VS Code 擴展開發指南

如需進一步支持或遇到問題，請參考相關文檔或聯繫項目維護人員。