使用说明

项目简介

Phabricator MCP Server 是一个 MCP (Model Context Protocol) 服务器的实现,它充当大型语言模型 (LLM) 客户端与 Phabricator 项目管理工具之间的桥梁。通过这个服务器,LLM 能够以标准化的方式访问 Phabricator 中的任务、项目和用户信息,从而实现更智能的项目管理和协作。

主要功能点

  • 任务管理: 支持查看 Phabricator 中任务的详细信息,包括任务ID、标题、状态、优先级、描述和评论。
  • 标准化接口: 遵循 MCP 协议,使用 JSON-RPC 进行通信,为 LLM 客户端提供统一的访问接口。
  • 工具注册和调用: 注册 "get-task" 工具,允许 LLM 客户端通过调用该工具获取任务信息。
  • 基于 Stdio 传输: 使用标准输入输出 (stdio) 作为默认的传输协议,简化部署和集成。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/MCP-Mirror/baba786_phabricator-mcp-server.git
    cd baba786_phabricator-mcp-server
  2. 创建并激活虚拟环境:

    python -m venv venv
    source venv/bin/activate   # Linux/macOS
    .\venv\Scripts\activate  # Windows
  3. 安装依赖:

    pip install -r requirements.txt
  4. 配置 Phabricator API Token:

    • 复制 '.env.example' 文件并重命名为 '.env':
      cp .env.example .env
    • 编辑 '.env' 文件,将 'your-token-here' 替换为你的 Phabricator API Token。
  5. 运行服务器:

    cd src
    python server.py

服务器配置

MCP 客户端需要以下配置信息来连接到 Phabricator MCP Server。这是一个 JSON 格式的配置示例,您需要将其提供给 MCP 客户端:

{
  "serverName": "phabricator-wmf-mcp",
  "command": "python",
  "args": ["src/server.py"]
}

配置参数说明:

  • 'serverName': 服务器名称,此处为 "phabricator-wmf-mcp"。
  • 'command': 启动服务器的命令,通常为 Python 解释器,例如 "python" 或 "python3"。 请确保您的 Python 环境中安装了所需的依赖。
  • 'args': 传递给 'command' 的参数列表,用于指定要运行的服务器脚本,此处为 '["src/server.py"]',指向仓库 'src' 目录下的 'server.py' 文件。

注意: 请确保 MCP 客户端能够访问到 Python 解释器 ('command') 和服务器脚本 ('args') 指定的路径。您可能需要根据您的实际环境调整 'command' 和 'args' 的值。

基本使用方法

服务器启动后,MCP 客户端可以通过 JSON-RPC 向服务器发送请求。例如,使用 'mcp_minimal_client.py' 中的示例代码,可以调用 'get-task' 工具来获取任务信息。

from src.mcp_minimal_client import Client

client = Client()
response = client.get_task(task_id="123")  # 将 "123" 替换为实际的任务 ID
print(response)

请参考仓库中的 'src/mcp_minimal_client.py' 和 'src/test_client.py' 文件,了解更多客户端的使用方法。

信息

分类

开发者工具