apm-mcp-server

apm-mcp-server

1
knowledge_and_memorydeveloper_tools

The apm-mcp-server is an MCP server designed to interact with the Agile Practice Map, allowing users to query and retrieve practice information through a knowledge base powered by a large language model. It offers tools and resources for querying and listing practices and is deployed using uv package manager and Docker.

apm-mcp-server: アジャイルプラクティスマップ MCPサーバー

概要

アジャイルプラクティスマップのデータと対話するためのMCPサーバーです。このサーバーは、大規模言語モデルを通じてアジャイルプラクティスマップ（※）のナレッジベースから情報を検索します。

※ https://www.agile-studio.jp/agile-practice-map

Tool

  1. query_apm

    • アジャイルプラクティスマップ（Agile Practice Map）に関する質問に回答します
    • 入力:
      • question (文字列): アジャイルプラクティスに関するユーザーの質問
    • 戻り値: アジャイルプラクティスマップのナレッジベースに基づく回答

  2. list_apm_practices

    • アジャイルプラクティスマップに含まれるプラクティス名の一覧を取得します
    • 入力: なし
    • 戻り値: プラクティス名のリスト

Resource

  1. resource://{practice_name}/url
    • 指定したプラクティス名のURLを返すリソース
    • 入力:
      • practice_name (文字列): プラクティス名（例: "daily-scrum"）
    • 戻り値: プラクティス名とURLの情報 { "practice_name": ..., "url": ... }

MCPサーバーのインストール

uvのインストール

まだインストールされていない場合、uvパッケージマネージャーをインストールする必要があります。

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

リポジトリのクローン

# リポジトリをクローンします。
git clone https://github.com/HappymanOkajima/apm-mcp-server.git

OpenAIのAPIキーの設定

apm-mcp-server 配下に.envファイルを作成してください。

.env ファイルの例:

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx

MCPクライアントの設定

Claude Desktopでの使用方法

claude_desktop_config.jsonに以下を追加してください。commandなど、ファイルパスは絶対パスで指定してください。※ Windowsを前提としたサンプルです。

{
  "mcpServers": {
    "apm-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "command": "c:\\YOUR_UV_PATH\\uv",
      "args": [
        "--directory",
        "C:\\YOUR_SERVER_INSTALL_PATH\\apm-mcp-server",
        "run",
        "-m",
        "apm_mcp_server"
      ],
      "transportType": "stdio"
    }
 }
}

Docker コンテナを使って MCP サーバーを実行する場合、Dockerビルド後、以下のようにクライアントを設定します。APIキーは、claude_desktop_config.json にて指定してください。

Dockerビルド:

docker build -t mcp/apm .

{
  "mcpServers": {
    "apm": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx",
        "mcp/apm"
      ]
    }
  }
}

Clineでの使用方法

Clineチャットに相談しながらインストール、設定してください。

プロジェクト構造

  • apm_mcp_server/: メインサーバーコード
    • main.py: MCPサーバーのエントリーポイント
    • rag_chroma/: Chroma DBを使用したRAG実装
  • data/: ソースデータとベクターデータベースを含む
    • apm.txt: アジャイルプラクティスマップのソーステキストデータ
    • chroma_db/: アジャイルプラクティスマップのデータ
  • tools/: ユーティリティスクリプト
    • populate_db.py: ソースデータからベクターデータベースを作成するスクリプト

データベース

設定を楽にするために、dataディレクトリ配下に、APMの情報が入ったchromaDBデータベースファイルがそのまま格納されています。

データベース構築ツール

コンテンツのURLまたはテキストファイルからベクトルデータベースを構築するツールが同梱されています。

uv run -m tools.populate_db

これにより、data/chroma_db/にベクトルデータベースが作成されます。なので、このツールを利用することで、APMに限らず、Webページやテキストファイルからナレッジを作成・追加できます。

ライセンス

このMCPサーバーはMITライセンスの下で公開されています。これにより、MITライセンスの条件に従って、ソフトウェアを自由に使用、変更、配布することができます。詳細については、プロジェクトリポジトリ内のLICENSEファイルをご覧ください。