使用说明

项目简介

Phabricator MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM 应用提供访问 Phabricator 协同工作平台的能力。通过此服务器，LLM 可以获取和操作 Phabricator 中的任务、项目和用户信息，从而实现与 Phabricator 的集成。

主要功能点

• 获取任务信息: 允许 LLM 客户端通过任务 ID 查询 Phabricator 任务的详细信息，包括标题、描述、状态、优先级和评论。

安装步骤

1. 克隆仓库到本地：

   git clone https://github.com/baba786/phabricator-mcp-server.git
   

2. 进入仓库目录：

   cd phabricator-mcp-server
   

3. 创建并激活虚拟环境：

   python -m venv venv
   source venv/bin/activate   # Linux/macOS
   .\venv\Scripts\activate  # Windows
   

4. 安装依赖：

   pip install -r requirements.txt
   

5. 配置环境变量：
   • 复制 '.env.example' 文件为 '.env'：

     cp .env.example .env
     

   • 编辑 '.env' 文件，将 'your-token-here' 替换为你的 Phabricator API Token。
6. 运行服务器：进入 'src' 目录：

   cd src
   

   执行 'python server.py' 启动服务器。

服务器配置

MCP 客户端需要配置以下信息以连接到 Phabricator MCP Server：

{
  "server name": "phabricator-wmf-mcp",  // 服务器名称，用于客户端识别
  "command": "python",                   // 启动服务器的命令，这里使用 python 解释器
  "args": ["server.py"]                 // 传递给 python 命令的参数，指定运行 server.py 文件
}

基本使用方法

服务器启动后，MCP 客户端可以使用 'get-task' 工具，通过提供任务 ID 来获取 Phabricator 任务的详细信息。具体工具和使用方法请参考客户端代码示例 ('src/mcp_minimal_client.py' 或 'src/test_client.py')。

例如，使用 'mcp_minimal_client.py' 中的客户端代码，可以执行以下操作：

1. 确保服务器已启动。
2. 运行客户端脚本 'python src/mcp_minimal_client.py'。
3. 客户端将列出可用的工具（目前为 'get-task'），并调用 'get-task' 工具获取任务信息。

请注意，此项目目前处于开发阶段，仅实现了获取任务信息的功能 ('get-task' 工具)。