MCP DOCKER Atlassian

このプロジェクトは、DockerベースのMCP Atlassian統合サービスを提供し、VS CodeのCopilot拡張機能を通じてConfluenceとJiraのリソースにアクセスしやすくします。

開発者ツール知識管理と記憶 #Dockerデプロイメント #Atlassian統合 #VS Code拡張機能 #MCPプロトコル .Python

スコア : 2ポイント

ダウンロード数 : 14

更新時間 : 2025-04-28

MCP Atlassianサーバーとは？

これはDockerコンテナで実行される中間サービスで、VS Code内でCopilotを通じて直接Atlassian ConfluenceとJiraの内容を照会および取得できます。Model Context Protocol (MCP)を使用してVS Codeと通信します。

MCP Atlassianサービスの使い方は？

提供されているDockerコンテナを実行し、VS CodeでMCPサーバーのアドレスを設定するだけで、チャットウィンドウでConfluenceドキュメントやJiraタスクを照会できます。

適用シナリオ

VS Code環境を離れることなく、プロジェクトドキュメント、技術仕様、またはタスクの状態をすばやく検索する必要がある場合に特に便利です。開発者がコーディング中に関連リソースをすばやく参照するのに適しています。

主な機能

Confluence統合VS Code内で直接Confluenceドキュメントの内容を検索および取得

Jira統合Jiraタスクの状態と詳細情報を照会

Dockerデプロイメント複雑な設定を必要とせず、簡単なワンクリックでDockerコンテナをデプロイできます。

SSEプロトコルサポートServer-Sent Eventsプロトコルを使用してVS Codeとリアルタイム通信

利点と制限

利点

アプリを切り替えることなくAtlassianのリソースにアクセスできます。

簡単なDockerデプロイメント方法

VS Code Copilotとシームレスに統合

複雑な検索クエリをサポート

制限

有効なAtlassian APIトークンが必要です。

Atlassian Cloudバージョンのみをサポート

初回設定にはいくつかの技術知識が必要です。

照会結果はユーザーの権限に制限されます。

使い方

リポジトリをクローンする

プロジェクトコードをローカルにダウンロードします。

環境変数を設定する

サンプル環境ファイルをコピーし、Atlassianアカウント情報に基づいて編集します。

サービスを起動する

起動スクリプトを実行してDockerコンテナを構築し、実行します。

VS Codeを設定する

VS Codeの設定にMCPサーバーの設定を追加します。

使用例

APIドキュメントを検索するAPIコードを記述する際に設計規範ドキュメントを参照する必要があります。

タスクの状態を確認する特定のJiraタスクが完了したかどうかを確認する必要があります。

未処理のタスクを検索する現在のプロジェクト内のすべての未処理のタスクを確認する必要があります。

よくある質問

MCPサーバーに接続できないのはなぜですか？

Atlassian APIトークンを取得するにはどうすればいいですか？

クエリが空の結果を返すのはなぜですか？

Confluenceの検索スペースを制限するにはどうすればいいですか？

🚀 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 で生成します。
- トークンは安全に保存してください。作成後は再度表示できません。

手順

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

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
```

✨ 主な機能

利用可能なスクリプト

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

📚 ドキュメント

トラブルシューティング

起動問題：
- Docker が正しくインストールされ、実行中であることを確認してください。
- スクリプトを実行するための十分な権限があることを確認してください。
- 出力ログを確認して詳細な情報を取得してください。
接続問題：
- サーバーが正常に起動し、指定されたアドレスで動作していることを確認してください。
- ネットワーク設定を確認し、ファイアウォールがアクセスをブロックしていないことを確認してください。
- .env ファイルの設定が正しいことを検証してください。

環境変数

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

属性	详情
`PORT`	サービスがリッスンするポートを設定します。デフォルトは 9001 です。
`API_KEY`	認証に使用する API トークンです。
`DB_URL`	データベース接続 URL で、jdbc:mysql://localhost:3306/database のような形式です。