github-projects-mcp

GitHub 项目 V2 MCP 服务器

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

特征

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

用法

此服务器可与任何 MCP 客户端（例如 Claude Desktop）一起使用。请将其添加到您的 MCP 客户端配置中（例如claude_desktop_config.json ）。

选项 1：使用已发布的包

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

确保将your_pat_here替换为您的实际 GitHub 个人访问令牌。

选项 2：从源代码

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

设置

1. 克隆存储库：
   git clone git@github.com: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 客户端：

确保将/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 问题添加到项目 V2
• update_project_item_field ：更新项目项的字段值
• create_draft_issue ：直接在 GitHub Project V2 中创建草稿问题
• delete_project_item ：从 GitHub 项目 V2 中删除一个项目

有关详细使用信息，请参阅服务器代码中的工具文档。

发展

该项目结构如下：

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

为了做出贡献，请确保：

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