Github Projects Mcp Server

GitHub Projects V2 MCP 服务

一个模型上下文协议（MCP）服务，通过 Claude 和其他 MCP 客户端提供管理 GitHub Projects V2 的工具。此服务使用 GitHub GraphQL API 与 GitHub Projects V2 交互。

功能

• 列出并查看用户和组织的 GitHub Projects V2
• 获取项目字段和项目条目（议题、PR、草稿议题）
• 创建议题并将其添加到项目
• 直接在项目中创建草稿议题
• 更新项目条目的字段值
• 从项目中删除条目

用法

此服务可与任何 MCP 客户端搭配使用，例如 Claude Desktop。将其添加到 MCP 客户端配置中（例如 claude_desktop_config.json）。

选项 1：使用已发布的软件包

以下是使用 uvx 作为命令运行器的配置示例：

{
  "mcpServers": {
    "github-projects": {
      "command": "uvx",
      "args": [
        "mcp-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "your_pat_here"
      }
    }
  }
}

请将 your_pat_here 替换为你实际的 GitHub 个人访问令牌。

选项 2：从源代码运行

若要直接从源代码运行此项目，请按以下步骤操作：

设置

1. 克隆仓库：

   git clone [email protected]:Arclio/github-projects-mcp.git
   cd github-projects-mcp
   

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

   uv venv
   source venv/bin/activate
   

3. 安装依赖项：

   uv pip install -e .
   

4. 将 GitHub 令牌设置为环境变量：

   创建 GitHub 个人访问令牌，并授予其所需权限。 所需权限包括：repo、project 和 read:org。

   运行此命令后，将令牌添加到 .env 文件中：

   cp .env.example .env
   

   然后将以下内容添加到 .env 文件中：

   export GITHUB_TOKEN=your_personal_access_token
   

从源代码运行

从源代码运行时，请按以下方式配置 MCP 客户端：

{
  "mcpServers": {
    "github-projects": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/github-projects-mcp",
        "run",
        "mcp-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "your_pat_here"
      }
    }
  }
}

请将 /path/to/github-projects-mcp 和 your_pat_here 替换为 实际的仓库路径和 GitHub 个人访问令牌。

可用工具

• list_projects：列出指定组织或用户的 GitHub Projects V2
• get_project_fields：获取 GitHub Project V2 中可用的字段
• get_project_items：获取 GitHub Project V2 中的条目（支持按 状态或自定义单选字段筛选）
• create_issue：创建新的 GitHub 议题
• add_issue_to_project：将现有 GitHub 议题添加到 Project V2
• update_project_item_field：更新项目条目的字段值
• create_draft_issue：直接在 GitHub Project V2 中创建草稿议题
• delete_project_item：从 GitHub Project V2 中删除条目

详细用法请参阅服务代码中的工具文档。

开发

项目结构如下：

• src/github_projects_mcp/：主软件包目录
  • server.py：包含工具定义的 MCP 服务实现
  • github_client.py：用于与 GitHub API 交互的 GraphQL 客户端

参与贡献时，请确保：

1. 为所有 GraphQL 操作添加适当的错误处理
2. 为所有函数和参数添加类型注解
3. 添加新工具或功能时更新文档