apm-mcp-server: 敏捷实践地图 MCP 服务器

概要

用于与敏捷实践地图数据交互的 MCP 服务器。该服务器通过大型语言模型，从敏捷实践地图（※）的知识库中进行 RAG 检索信息。

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

工具

1. query_apm

   • 回答关于敏捷实践地图（Agile Practice Map）的问题
   • 输入:
     • 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=sk-xxxxxxxxxxxxxxxxxxxx

配置

Claude Desktop 的使用方法

请将以下内容添加到 claude_desktop_config.json 中。※通常需要指定绝对路径才能正常工作。

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

如果使用 Docker 容器运行 MCP 服务器，请按如下方式配置。

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: 从源数据创建向量数据库的脚本

数据库构建工具

包含一个从内容 URL 或文本文件构建向量数据库的工具。

uv run -m tools.populate_db

这将会在 data/chroma_db/ 中创建一个向量数据库。

许可证

此 MCP 服务器在 MIT 许可证下发布。 这允许您根据 MIT 许可证的条款自由使用、修改和分发该软件。 有关详细信息，请参阅项目存储库中的 LICENSE 文件。