AI导哈

GitHub项目管理工具

一个将GitHub Projects (v2)操作暴露为工具的MCP服务器，允许AI助手在GitHub项目板上列出、查看、创建、编辑和归档项目。

  • by hiibolt
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hiibolt/github-projects-mcp

使用说明

github项目mcp

一个MCP（模型上下文协议）服务器，将GitHub项目（v2）操作作为工具公开。它包裹着 gh 命令行界面 让AI助手在GitHub项目板上列出、查看、创建、编辑和存档项目。

先决条件

设置

git clone https://github.com/hiibolt/github-projects-mcp.git
cd github-projects-mcp
npm install   # or: bun install

用法

克劳德代码

添加到您的Claude Code MCP配置中(.claude/settings.json 或 .claude/settings.local.json):

{
  "mcpServers": {
    "github-projects": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/path/to/github-projects-mcp/index.ts"],
      "env": {
        "GH_OWNER": "your-github-username-or-org"
      }
    }
  }
}

其他MCP客户端

任何兼容MCP的客户端都可以通过stdio连接。服务器二进制文件是贯穿的TypeScript入口点 tsx:

npx tsx index.ts

配置

环境变量 描述 默认值
GH_OWNER 项目操作的默认GitHub用户或组织 @me （经过身份验证的用户）

工具

阅读

工具 说明
list_projects 列出用户或组织的GitHub项目
view_project 按编号查看特定项目的详细信息
list_fields 列出项目中的所有字段（列）--返回字段ID、类型和所需的选择选项 edit_item
list_items 列出项目中的项目及其所有字段值

写

工具 说明
add_item 通过URL将现有问题或PR添加到项目中
create_draft_item 直接在项目中创建新的草稿问题
edit_item 更新项目项上的字段值（文本、数字、日期、单选、迭代或清除）
archive_item 存档或取消存档项目项

工作流示例

更新项目板项的典型工作流程：

  1. list_projects --查找您的项目编号
  2. view_project --获取项目ID
  3. list_fields --获取字段ID和单选选项ID（例如，状态选项）
  4. list_items --找到要更新的项目ID
  5. edit_item --使用上面的ID设置字段值

许可证

麻省理工学院

相关 MCP