敏捷实践知识库查询工具

一个通过大语言模型从敏捷实践知识库中检索信息的MCP服务器,支持查询实践信息和获取实践列表。

  • by HappymanOkajima
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 happymanokajima/apm-mcp-server

使用说明

apm-mcp-server: 调整实践图MCP服务器

概要

用于与调整实践图中的数据交互MCP服务器。此服务器通过大规模语言模型从“调整实践图”(※)的知识库中搜索信息。

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

工具

  1. query_apm

    • 回答有关“调整实践映射”的问题
    • 入力:
      • question (字符串):用户关于调整实践的问题
    • 返回值:基于知识库的调整实践映射回答
  2. list_apm_实践

    • 获取包含在调整实践图中的实践名称列表
    • 输入:无
    • 返回值:实践名称列表

资源

  1. 资源://{practice_name}/url
    • 单击功能区上URL返回的资源
    • 入力:
      • practice_name (字符串):实践名称(例如,“daily-scrum”)
    • 返回值:实践名称和URL的信息 { "practice_name": ..., "url": ... }

MCP安装服务器

uv安装

如果尚未安装uv必须安装包管理器。

窗户:

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

MCP客户端设置

Claude Desktop使用方法

claude_desktop_config.json中所述修改相应参数的值。command等已弃用的函数的缺少的支持。※ Windows的规格化距离的幂函数。

{
  "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"
    }
 }
}

Docker 使用集装箱MCP 在动态输入提示中单击Docker构建后,如下所示设置客户端:。API关键点为claude_desktop_config.json 中所述修改相应参数的值。

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

数据库

为了方便设定data在您查看完详细信息后,单击APM消息chromaDB数据库文件保持原样。

数据库生成工具

内容URL或从文本文件构建矢量数据库的工具。

uv run -m tools.populate_db

因此data/chroma_db/中所述修改相应参数的值。所以,通过利用这个工具APM不限于Web可以从页面或文本文件创建和添加知识。

许可证

这个MCP服务器是MIT在许可证下公开。因此MIT您可以根据许可条件自由使用、修改和分发软件。有关详细信息,请参见LICENSE请看文件。