Agile Luminary Mcp

Agile Luminary MCP サーバー

これは、AI クライアント（Cursor や Claude Desktop など）を、https://agileluminary.com でホストされている Agile Luminary プロジェクト管理システムに接続する Model Context Protocol（MCP）サーバーです。

MCP とは？

Model Context Protocol（MCP）は、AI アプリケーションを外部のデータソースやサービスに接続するための標準的な方法です。このサーバーは、AI クライアントと Agile Luminary REST API の橋渡しをし、AI との会話の中でプロジェクトの詳細、作業の割り当て、ドキュメントを直接取得できるようにします。

アーキテクチャ

AI Client (Cursor/Claude) → Local MCP Server → Agile Luminary API (localhost:5006)

機能

この MCP サーバーは、Agile Luminary API からデータを取得する 3 つの主要なツールを提供します。

📚 getRelatedDocuments

• 目的：検索文字列に基づいて関連ドキュメントを取得します
• パラメーター：searchString（必須）— ドキュメント内を検索するテキスト
• 使用例：現在の作業に関連するドキュメントや仕様を探します

📋 getCurrentWork

• 目的：現在ユーザーに割り当てられている作業を取得します
• パラメーター：なし
• 使用例：現在自分に割り当てられているタスクやユーザーストーリーを確認します

🔍 getPastWork

• 目的：検索条件に基づいて、ユーザーストーリーに関連する完了済みの作業を取得します
• パラメーター：searchString（必須）— 関連する過去の作業を探すための検索語
• 使用例：より適切な判断のために、過去の経緯や完了済みのタスクを確認します

インストールとセットアップ

前提条件

• Node.js（v16 以降）
• MCP に対応した AI クライアント（Cursor IDE、Claude Desktop など）

依存関係のインストール

npm install @modelcontextprotocol/sdk zod

環境変数

API キーを環境変数として設定します。

export LUMINARY_API_KEY=your_api_key_here

サーバーの起動

node server.js

サーバーが起動し、stdio トランスポート経由で AI クライアントからの接続を待ち受けます。

設定

Cursor IDE の場合

MCP 設定に以下を追加します。

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop の場合

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用例

接続すると、AI クライアントで自然言語を使って操作できます。

• 「認証に関するドキュメントを検索して」
• 「現在の作業割り当てを表示して」
• 「ユーザーログイン機能に関連する過去の作業を探して」
• 「決済システムについて、どのようなドキュメントがありますか？」
• 「現在の作業に基づいて、以前に完了した類似のタスクを教えて」

API エンドポイント

このサーバーは、以下の Agile Luminary API エンドポイントに接続します。

• POST http://localhost:5006/bend/mcp/documents/search - ドキュメントを検索
• GET http://localhost:5006/bend/mcp/userstories/current - 現在の作業を取得
• POST http://localhost:5006/bend/mcp/userstories/search - 過去の作業を検索

メリット

• リアルタイムデータ：デプロイ済みシステムから常に最新のプロジェクト情報を取得できます
• コンテキストを理解する AI：AI アシスタントがプロジェクトの状況とドキュメントを十分に把握できます
• シームレスな統合：開発環境内で直接動作します
• 安全性：サーバーが認証と API 通信をローカルで処理します
• 検索機能：インテリジェントな検索で関連ドキュメントや過去の作業を見つけられます

認証

サーバーは認証に LUMINARY_API_KEY 環境変数を使用します。このキーは、すべての API リクエストの Authorization ヘッダーに渡されます。サーバーを起動する前に、この環境変数を設定してください。

エラー処理

サーバーには、以下に対する包括的なエラー処理が含まれています。

• ネットワーク接続の問題
• API 認証の失敗
• 不正な形式のレスポンス
• サービスの利用不可
• API キーの未設定

コントリビューション

この MCP サーバーは、Agile Luminary プロジェクト管理システム専用に設計されています。変更や機能強化を行う場合は、既存の API エンドポイントとの互換性を確保してください。

---

注：この MCP サーバーを使用する前に、Agile Luminary アカウントを作成し、https://agileluminary.com から API キーを取得してください。API キーを LUMINARY_API_KEY 環境変数に設定してください。