Apm MCP Server

🚀 敏捷實踐地圖 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 文件。