MCP Agileday

🚀 Agileday MCP Server

Agileday用のModel Context Protocol (MCP) サーバーです。このサーバーは、Agiledayの能力と従業員データをLLM（Claude DesktopやCursorなど）と橋渡しします。組織のスキルに関する自然言語の質問を行い、専門家を見つけ、能力プロファイルを探索できます。

✨ 主な機能

このサーバーは以下のツールを実装しています。

• find_experts_with_skill
  • クエリ: "Who knows React?"
  • アクション: 特定のスキルを持つ従業員を検索し、その習熟度を返します。
• get_employee_competence_profile
  • クエリ: "What are Jane Doe's top skills?"
  • アクション: 特定の従業員のスキル、習熟度、動機の完全なリストを取得します。
• list_organization_skills
  • クエリ: "What skills do we have in the organization?"
  • アクション: Agiledayワークスペースで利用可能なスキルの完全な分類体系をカテゴリ別に取得します。これにより、AIが正確に検索する用語を理解し、推測を避けることができます。

📦 インストール

サーバーを実行するには、以下の環境変数が必要です。

🚀 クイックスタート

Dockerを使用する場合

GitHub Container Registryの事前構築済みDockerイメージを使用してサーバーを実行するのが最も簡単です。

1. Claude Desktopで実行する

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

{
  "mcpServers": {
    "agileday": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "AGILEDAY_TENANT_ID=your_tenant_id",
        "-e", "AGILEDAY_API_TOKEN=your_api_token",
        "ghcr.io/eficode/mcp-agileday:latest"
      ]
    }
  }
}

2. Dockerを使用する

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

   git clone [https://github.com/yourusername/agileday-mcp-server.git](https://github.com/yourusername/agileday-mcp-server.git)
   cd agileday-mcp-server
   

2. イメージをビルドします。

   docker build -t agileday-mcp-server .
   

3. Claude Desktopを設定します。 claude_desktop_config.json（macOSでは通常~/Library/Application Support/Claude/、Windowsでは%APPDATA%\Claude\にあります）に以下を追加します。

   {
     "mcpServers": {
       "agileday": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e", "AGILEDAY_TENANT_ID=your_tenant_id",
           "-e", "AGILEDAY_API_TOKEN=your_api_token",
           "agileday-mcp-server"
         ]
       }
     }
   }
   

4. Claude Desktopを再起動します。

3. ローカルのPythonを使用する

1. リポジトリをクローンし、依存関係をインストールします。

   git clone [https://github.com/yourusername/agileday-mcp-server.git](https://github.com/yourusername/agileday-mcp-server.git)
   cd agileday-mcp-server
   pip install -r requirements.txt
   

2. Claude Desktopを設定します。 claude_desktop_config.jsonを更新して、Pythonスクリプトを指すようにします。

   {
     "mcpServers": {
       "agileday": {
         "command": "python3",
         "args": ["/absolute/path/to/agileday_server.py"],
         "env": {
           "AGILEDAY_TENANT_ID": "your_tenant_id",
           "AGILEDAY_API_TOKEN": "your_api_token"
         }
       }
     }
   }
   

4. サービスとして実行する

これをスタンドアロンサービスとしてデプロイする場合（例えば、リモートアクセスやHTTPトランスポートをサポートするクライアント用）は、httpトランスポートモードを使用します。

  docker run -d \
    -p 8000:8000 \
    -e AGILEDAY_TENANT_ID=your_tenant \
    -e AGILEDAY_API_TOKEN=your_token \
    ghcr.io/eficode/mcp-agileday:latest \
    --transport http

サーバーは以下の場所で利用できます。

ユニバーサルエンドポイント: http://localhost:8000/mcp (SSEストリームとPOSTメッセージの両方をサポート)

ヘルスチェック: http://localhost:8000/health

💻 使用例

接続後、Claudeに以下のような質問をすることができます。

• "Who are the experts in Python at our company?"
• "Find me someone who knows Service Design and has a high proficiency."
• "What is Jane Doe's competence profile?"
• "Do we have enough people with Kubernetes skills?"

⚠️ セキュリティに関する注意事項

• APIトークン: AGILEDAY_API_TOKENをバージョン管理にコミットしないでください。常に環境変数またはローカル設定ファイルを介して渡してください。
• 読み取り専用アクセス: 可能であれば、読み取り専用の権限を持つAPIトークンを使用することをお勧めします。このツールはデータを取得するだけです。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. あなたの機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. プルリクエストを開きます。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。