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

概述

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

参考链接

工具

1. query_apm

   • 回答与敏捷实践地图相关的问题
   • 输入:
     • question (字符串): 用户关于敏捷实践的提问
   • 输出: 基于敏捷实践地图知识库的回答

2. list_apm_practices

   • 获取敏捷实践地图中包含的所有实践名称列表
   • 输入: 无
   • 输出: 实践名称列表

资源

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

项目结构

• data目录: 包含构建好的向量数据库文件。
• tools目录: 提供一些实用脚本，用于从源数据构建向量数据库。

数据库

为了方便配置，默认在 data 目录下存储了基于敏捷实践地图信息的 ChromaDB 数据库文件。

数据库构建工具

提供了一个工具，可以从内容 URL 或文本文件中构建向量数据库。

运行以下命令：

uv run -m tools.populate_db

这将生成 data/chroma_db/ 目录下的向量数据库。因此，您可以使用此工具从 Web 页面或文本文件创建和扩展知识库。

许可证

该MCP服务器基于 MIT 许可证发布。根据许可条款，您可以在遵守条件的情况下自由使用、修改和分发软件。更多详情请参阅项目仓库中的 LICENSE 文件。