apm-mcp-server: アジャイルプラクティスマップ MCPサーバー
About
apm-mcp-server is an MCP server that lets large language models query the Agile Practice Map knowledge base. It serves users who need programmatic access to agile practice information through natural language questions or list retrieval.
Details
- Author
- HappymanOkajima
- GitHub stars
- 1
- Downloads
- 115
- Categories
- Other
Jump to
- Two MCP tools: query_apm and list_apm_practices
- Resource to retrieve a practice’s URL by name
- Built‑in Chroma DB vector database with Agile Practice Map data
- Ready‑to‑run from cloned repository with uv
- Docker deployment option for containerized environments
- Included populate_db script to build custom knowledge bases
- MIT licensed – free to use, modify, and distribute
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
apm-mcp-server: アジャイルプラクティスマップ MCPサーバーCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python and the uv package manager, then clone the repository and set an OpenAI API key in a .env file. Configure your MCP client (e.g., Claude Desktop) to run the server with uv run -m apm_mcp_server or via Docker. Use the query_apm tool to ask questions and list_apm_practices to get all practice names. A pre-built Chroma DB vector database is included for immediate use.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"apm-mcp-server: \u30a2\u30b8\u30e3\u30a4\u30eb\u30d7\u30e9\u30af\u30c6\u30a3\u30b9\u30de\u30c3\u30d7 mcp\u30b5\u30fc\u30d0\u30fc": {
"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"
}
}
}
}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"
}
}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
リポジトリのクローン
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
