MCP DOCKER Atlassian

🚀 MCP-DOCKER-Atlassian 日本語ドキュメント

このプロジェクトは、Docker をベースにした Atlassian の統合設定で、VS Code の Copilot MCP 拡張機能と一緒に使用できます。このリポジトリには、Model Context Protocol を通じて Confluence と Jira のリソースにアクセスする MCP Atlassian サーバーを Docker コンテナ内で簡単に実行するための設定とスクリプトが含まれています。

⚠️ 重要な注意

上流プロジェクトから引き継いだ MyPy の型チェック問題は解決されました。型チェックシステムは完全に正常に動作し、すべてのチェックが通過しています。

🚀 クイックスタート

前提条件

• Docker がインストールされ、実行中であること
• Visual Studio Code に Copilot Chat 拡張機能がインストールされていること
• Atlassian クラウドアカウントと API トークン
  • トークンは https://id.atlassian.net/manage-profile/security/api-tokens で生成します。
  • トークンは安全に保存してください。作成後は再度表示できません。

手順

1. リポジトリをクローンする：

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

2. 認証情報を設定する： サンプル環境ファイルをコピーして編集します。

   cp .env.example .env
   # .env ファイルを編集して Atlassian の認証情報を入力します。
   

   注意：.env ファイルでは引用符を使用しないでください。

3. スクリプトを実行可能にする：

   chmod +x *.sh
   

4. MCP サーバーを起動する：

   ./start-mcp.sh
   

   サーバーは http://localhost:9001/sse で起動します。

   MCP サーバーを停止する：

   ./stop-mcp.sh
   

5. VS Code を設定する： VS Code の settings.json に以下を追加します。

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

6. サーバーを停止して完了：

   ./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 = '進行中'"

📚 ドキュメント

トラブルシューティング

1. 起動問題：

   • Docker が正しくインストールされ、実行中であることを確認してください。
   • スクリプトを実行するための十分な権限があることを確認してください。
   • 出力ログを確認して詳細な情報を取得してください。

2. 接続問題：

   • サーバーが正常に起動し、指定されたアドレスで動作していることを確認してください。
   • ネットワーク設定を確認し、ファイアウォールがアクセスをブロックしていないことを確認してください。
   • .env ファイルの設定が正しいことを検証してください。

環境変数

MCP サーバーは以下の環境変数で構成されます。

参考リソース

このプロジェクトは以下のリソースとライブラリに基づいています。

• 公式 MCP ドキュメント
• Docker 公式ドキュメント
• VS Code 拡張開発ガイド

さらなるサポートが必要な場合や問題が発生した場合は、関連ドキュメントを参照するか、プロジェクトのメンテナに連絡してください。