GitHub Project Manager MCP Server

GitHub Project Manager MCP Server

site icon
2025.04.15 18
TypeScript项目管理GitHub 集成MCP 实现开发效率交流协作
GitHub Project Manager MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,旨在通过标准化的工具和资源提供 GitHub 项目的功能。该服务允许 LLM 客户端通过 MCP 接口以编程方式管理 GitHub 项目。
View on GitHub

Overview

基本能力

产品定位

GitHub Project Manager MCP Server 是一个用于管理 GitHub 项目的服务,通过 MCP 协议提供标准化的工具和资源,使 LLM 客户端能够以编程方式管理 GitHub 项目。

核心功能

  • 项目管理
  • 创建和管理 GitHub Projects (v2)
  • 处理项目设置和配置
  • 管理项目可见性和访问权限

  • 项目资源管理

  • 问题和里程碑管理
  • 冲刺规划和跟踪
  • 自定义字段和视图
  • 资源版本控制和锁定

  • MCP 实现

  • 完全符合 MCP 规范
  • 标准化工具定义
  • 资源状态管理
  • 渐进式响应处理
  • 全面的错误处理

  • GitHub 集成

  • GraphQL API 集成
  • 速率限制处理
  • 乐观并发控制
  • Webhook 支持(计划中)

适用场景

  • 团队协作项目管理
  • 开发流程中的冲刺规划和跟踪
  • 问题和里程碑管理
  • 自定义字段和视图配置

工具列表

  • 项目管理工具:用于创建和管理 GitHub 项目。
  • 里程碑管理工具:用于管理项目中的里程碑。
  • 冲刺规划工具:用于规划和跟踪冲刺进度。
  • 问题管理工具:用于管理项目中的问题。

常见问题解答

  • 如何获取 GitHub Token?:需要在 GitHub 设置中生成具有 repoprojectwrite:org 权限的 Token。
  • 如何配置环境变量?:复制 .env.example.env 并填写相应的 GitHub Token 和仓库信息。

使用教程

使用依赖

# 安装依赖
npm install
# 或
pnpm install

安装教程

# 设置环境变量
cp .env.example .env
# 编辑 .env 文件,填写 GitHub Token 和仓库信息

调试方式

# 启动 MCP 服务器
npm start

# 运行测试
npm test
npm run test:e2e

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。