🚀 敏捷实践地图 MCP 服务器
这是一个用于与敏捷实践地图（Agile Practice Map）数据进行交互的MCP服务器，借助大型语言模型从敏捷实践地图的知识库中检索信息，为用户提供敏捷实践相关的知识支持。
🚀 快速开始
本服务器提供了与敏捷实践地图数据交互的功能，可通过相关工具进行信息查询和实践名称获取等操作。同时，还提供了数据库构建工具，方便用户创建和扩展知识库。
✨ 主要特性
- 信息检索：通过大型语言模型从敏捷实践地图的知识库中检索信息。
- 工具丰富：提供
query_apm和list_apm_practices等工具，方便用户与敏捷实践地图数据进行交互。 - 资源获取：可通过
resource://{practice_name}/url获取指定实践名称的 URL 信息。 - 数据库构建：提供数据库构建工具，可从内容 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
💻 使用示例
基础用法
query_apm
# 回答与敏捷实践地图相关的问题
# 输入:
# question (字符串): 用户关于敏捷实践的提问
# 输出: 基于敏捷实践地图知识库的回答
list_apm_practices
# 获取敏捷实践地图中包含的所有实践名称列表
# 输入: 无
# 输出: 实践名称列表
resource://{practice_name}/url
# 返回指定实践名称的URL信息
# 输入:
# practice_name (字符串): 实践名称（例如："daily-scrum"）
# 输出: 包含实践名称和URL的信息 { "practice_name": ..., "url": ... }
高级用法
数据库构建
# 运行以下命令构建向量数据库
uv run -m tools.populate_db
运行此命令将生成 data/chroma_db/ 目录下的向量数据库，可用于从 Web 页面或文本文件创建和扩展知识库。
📚 详细文档
项目结构
- data 目录：包含构建好的向量数据库文件。
- tools 目录：提供一些实用脚本，用于从源数据构建向量数据库。
数据库
为了方便配置，默认在 data 目录下存储了基于敏捷实践地图信息的 ChromaDB 数据库文件。
🔧 技术细节
本项目通过大型语言模型从敏捷实践地图的知识库中检索信息，使用 ChromaDB 存储基于敏捷实践地图信息的数据库文件。同时，提供了相关工具和脚本，方便用户与数据库进行交互和构建。
📄 许可证
该 MCP 服务器基于 MIT 许可证发布。根据许可条款，您可以在遵守条件的情况下自由使用、修改和分发软件。更多详情请参阅项目仓库中的 LICENSE 文件。