Atlassian MCP Server Client

Atlassian MCP サーバークライアント

Model Context Protocol（MCP）サーバーに接続するためのコマンドラインクライアントです。特に、Atlassian の公式 MCP サーバー統合と連携するように設計されています。このクライアントは、OpenAI を利用した対話型チャットインターフェースを提供し、リモート MCP サーバーとスムーズにやり取りできます。

🚀 機能

• リモート MCP サーバーへの接続：mcp-remote を介して任意の MCP サーバーに接続します
• 対話型チャットインターフェース：OpenAI と連携したコマンドラインチャットインターフェースです
• OAuth サポート：mcp-remote を通じて Atlassian サービスの OAuth を自動的に処理します
• ツールの検出：MCP サーバーが提供するツールを自動的に検出して利用します
• ストリーミング応答：AI の応答をリアルタイムでストリーミングします
• クロスプラットフォーム対応：Windows、macOS、Linux で動作します

📋 前提条件

• Node.js 18.0.0 以降
• npm パッケージマネージャー
• OpenAI API キー

🛠️ インストール

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

   git clone <repository-url>
   cd jira-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. 環境変数を設定します：

   cp env.example .env
   

4. OpenAI API キーを設定します： .env ファイルを編集します：

   # OpenAI Configuration
   OPENAI_API_KEY=your_openai_api_key
   

🔐 OpenAI API キーの取得

1. OpenAI API キーにアクセスします
2. 新しい API キーを作成します
3. .env ファイルにコピーします

🚀 使用方法

Atlassian の公式 MCP サーバーに接続する

npm run dev

デフォルトでは、https://mcp.atlassian.com/v1/sse に接続します。

カスタム MCP サーバーに接続する

npm run dev <server-url>

例：

npm run dev wss://your-custom-mcp-server.com

開発用コマンド

• npm run build - TypeScript を JavaScript にコンパイルします
• npm run dev [server-url] - 開発モードで実行します（デフォルトでは Atlassian MCP サーバーに接続します）
• npm run clean - ビルド成果物を削除します
• npm run typecheck - TypeScript の型チェックを実行します

💬 対話型チャット

接続すると、次の操作ができる対話型プロンプトが表示されます：

• Atlassian ワークスペースについて質問する（Atlassian MCP サーバーに接続している場合）
• 自然言語を使って、MCP サーバーが提供する任意のツールを操作する
• 接続先サーバーの機能を使って、AI が生成した応答を取得する

セッション例

🔗 Connecting to remote MCP server: https://mcp.atlassian.com/v1/sse
🔐 OAuth authentication will be handled automatically by mcp-remote
🌐 A browser window may open for authentication
🤝 Connecting to MCP server...
🛠️ Setting up tools...
✅ Connected successfully with tools: [list-jira-issues, search-confluence, ...]

💬 Chat with AI (type 'help' for commands, 'exit' to quit):
> What are my recent Jira issues?

🤖 Processing query...
Here are your recent Jira issues...

特別なコマンド

• help - 利用可能なコマンドと使用方法を表示します
• list-tools - 接続先の MCP サーバーで利用できるすべてのツールを表示します
• exit または quit - アプリケーションを終了します

🔧 設定

環境変数

変数	説明	必須
OPENAI_API_KEY	OpenAI API キー	✅

OAuth 認証

Atlassian の MCP サーバーに接続する際、OAuth 認証は mcp-remote によって自動的に処理されます。必要に応じて、Atlassian アカウントで認証するためのブラウザーウィンドウが開きます。

🏗️ アーキテクチャ

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   CLI Client    │◄──►│   mcp-remote    │◄──►│   MCP Server    │
│   (this app)    │    │                 │    │   (Atlassian)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   OpenAI API    │    │ OAuth Handler   │    │ Atlassian APIs  │
│                 │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

🛠️ 動作の仕組み

1. 接続：クライアントは mcp-remote を使って、指定された MCP サーバーへの接続を確立します
2. 認証：OAuth フローは mcp-remote によって自動的に処理されます
3. ツールの検出：MCP サーバーから利用可能なツールを検出します
4. チャットインターフェース：検出されたツールを使って、OpenAI でユーザーの質問を処理します
5. ツールの実行：必要に応じて、リモート MCP サーバー上のツールを呼び出します

🐛 トラブルシューティング

よくある問題

1. 「OPENAI_API_KEY is not set」

   • .env ファイルに有効な OpenAI API キーが含まれていることを確認してください

2. 「mcp-remote installation failed」

   • アプリケーションは mcp-remote をグローバルに自動インストールしようとします
   • 失敗した場合は、手動でインストールしてください：npm install -g mcp-remote

3. OAuth 認証に失敗する

   • Atlassian ワークスペースへのアクセス権があることを確認してください
   • ブラウザーで認証ドメインからのポップアップが許可されていることを確認してください
   • ネットワーク接続を確認してください

4. 接続がタイムアウトする

   • MCP サーバーの URL が正しく、アクセス可能であることを確認してください
   • ファイアウォールの設定で外部への接続が許可されていることを確認してください

デバッグモード

詳細なログを確認するには、mcp-remote のログを確認するか、ソースコードを変更してログを追加してください。

🔗 依存関係

• @ai-sdk/openai：AI 機能を利用するための OpenAI 統合
• @modelcontextprotocol/sdk：クライアント実装用の公式 MCP SDK
• mcp-remote：リモート MCP サーバー接続ユーティリティ（自動インストール）
• ai：ツール統合とストリーミングに対応する AI SDK

📚 詳細情報

• Model Context Protocol - 公式 MCP ドキュメント
• Atlassian MCP Server - Atlassian の公式 MCP サーバー
• OpenAI API Documentation - OpenAI API リファレンス

---

注：これは MCP サーバーに接続するためのクライアントアプリケーションです。実際の MCP サーバー実装については、Atlassian の公式 MCP サーバーのドキュメントを参照してください。