Apm MCP Server

🚀 apm - mcp - server：アジャイル実践マップ MCP サーバー

このサーバーは、アジャイル実践マップ（Agile Practice Map）のデータとやり取りするためのMCPサーバーです。大型言語モデルを通じて、アジャイル実践マップの知識ベースから情報を検索します。

参考リンク

🚀 クイックスタート

このアジャイル実践マップMCPサーバーは、大型言語モデルを利用して、敏捷实践地图の知識ベースから情報を検索することができます。以下に、サーバーの使用方法やインストール手順を紹介します。

✨ 主な機能

ツール

1. query_apm

   • アジャイル実践マップに関する質問に回答します。
   • 入力:
     • question (文字列): ユーザーがアジャイル実践について行った質問
   • 出力: アジャイル実践マップの知識ベースに基づく回答

2. list_apm_practices

   • アジャイル実践マップに含まれるすべての実践名のリストを取得します。
   • 入力: なし
   • 出力: 実践名のリスト

リソース

1. resource://{practice_name}/url
   • 指定された実践名のURL情報を返します。
   • 入力:
     • practice_name (文字列): 実践名（例："daily - scrum"）
   • 出力: 実践名とURLを含む情報 { "practice_name": ..., "url": ... }

📦 インストール

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=your_api_key_here

📚 ドキュメント

プロジェクト構造

• dataディレクトリ: 構築されたベクトルデータベースファイルが含まれています。
• toolsディレクトリ: ソースデータからベクトルデータベースを構築するための実用スクリプトが提供されています。

データベース

設定を容易にするため、デフォルトで data ディレクトリにアジャイル実践マップ情報に基づくChromaDBデータベースファイルが保存されています。

データベース構築ツール

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

以下のコマンドを実行します。

uv run -m tools.populate_db

これにより、data/chroma_db/ ディレクトリにベクトルデータベースが生成されます。したがって、このツールを使用してWebページまたはテキストファイルから知識ベースを作成および拡張することができます。

📄 ライセンス

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