remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides GitHub Projects functionality through the MCP interface, allowing management of projects, issues, milestones, sprints, and custom fields using GitHub's GraphQL API
Uses GitHub's GraphQL API to interact with GitHub Projects, handling API integration, rate limits, and optimistic concurrency

GitHub 项目管理器 MCP 服务器

模型上下文协议 (MCP) 服务器实现，通过标准化工具和资源提供 GitHub 项目功能。该服务器使 LLM 客户端能够通过 MCP 接口以编程方式管理 GitHub 项目。

概述

该服务器实现了模型上下文协议 (MCP) ，以便向 LLM 客户端公开 GitHub 项目功能。它提供了通过 GitHub 的 GraphQL API 管理项目、里程碑、冲刺和指标的工具，同时根据 MCP 规范维护状态并处理错误。

主要特点

项目管理
- 创建和管理 GitHub 项目 (v2)
- 处理项目设置和配置
- 管理项目可见性和访问权限
项目资源
- 问题和里程碑管理
- Sprint 规划和跟踪
- 自定义字段和视图
- 资源版本控制和锁定
MCP 实现
- 完全符合 MCP 规范
- 通过 Zod 验证实现标准化工具定义
- 资源状态管理
- 渐进式响应处理
- 全面的错误处理
GitHub 集成
- GraphQL API 集成分页支持
- 智能速率限制处理
- 乐观并发
- Webhook 支持（计划中）

安装

# Install dependencies
npm install
# or
pnpm install

# Set up environment variables
cp .env.example .env
# Edit .env with your GitHub token and details

配置

所需的环境变量：

GITHUB_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name

GitHub 令牌需要以下权限：

repo （完整存储库访问）
project （项目访问）
write:org （组织访问）

用法

# Start the MCP server
npm start

# Run tests
npm test
npm run test:e2e

请参阅用户指南以了解详细的使用说明。

建筑学

该服务器遵循清晰架构原则，具有不同的层次：

领域层：核心实体、存储库接口和 Zod 模式
基础设施层：GitHub API 集成和实现
服务层：业务逻辑协调
MCP 层：工具定义和请求处理

有关详细的架构文档，请参阅ARCHITECTURE.md 。

当前状态

核心功能

特征	地位	笔记
项目创建	✅ 完成	全面支持 v2 项目
里程碑管理	✅ 完成	已实施 CRUD 操作
Sprint 计划	✅ 完成	包括指标跟踪
问题管理	✅ 完成	支持自定义字段
资源版本控制	✅ 完成	使用乐观锁定和模式验证
Webhook 集成	📅 已计划	实时更新

MCP 实现

成分	地位	笔记
工具定义	✅ 完成	所有核心工具均通过 Zod 验证实现
资源管理	✅ 完成	使用乐观锁定和关系跟踪
响应处理	✅ 完成	具有多种内容类型的丰富内容格式
错误处理	✅ 完成	全面错误映射到 MCP 错误代码
状态管理	✅ 完成	具有冲突解决和速率限制

已确定的功能差距

尽管最近有所改进，但仍然存在以下功能差距，并需优先考虑未来的发展：

持久缓存策略：
- 虽然 ResourceCache 提供了内存缓存，但它在服务器重启后缺乏持久性
- 多实例部署没有分布式缓存
- 缺少内存管理的缓存驱逐策略
实时事件处理：
- 没有集成 webhook 来实现 GitHub 的实时更新
- 缺少基于事件的客户端订阅系统
- 缺乏对流更新的服务器发送事件 (SSE) 支持
高级 GitHub 项目 v2 功能：
- 对自定义字段类型和验证的支持有限
- 与 GitHub 较新的 Projects v2 字段类型的集成不完整
- 缺少自动化规则管理
性能优化：
- 没有针对相关资源的查询批处理
- 缺少频繁访问资源的后台刷新
- 相关资源预取不完整
数据可视化和报告：
- 没有内置的指标可视化生成器
- 缺少报告生成功能
- 有限的时间序列数据分析

有关详细的实施状态，请参阅docs/mcp/gaps-analysis.md 。

文档

用户指南- 详细使用说明
架构——系统架构和设计
贡献- 开发指南
MCP 文档- MCP 特定细节

发展

测试

# Unit tests
npm test

# Integration tests
npm run test:integration

# End-to-end tests
npm run test:e2e

代码质量

# Lint code
npm run lint

# Type check
npm run type-check

# Format code
npm run format

贡献

请参阅CONTRIBUTING.md了解开发指南。

执照

麻省理工学院

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

提供用于管理 GitHub 项目、里程碑、任务和冲刺的全面工具。该服务器与 GitHub Projects V2 深度集成，提供自动化看板工作流、冲刺计划和自定义字段管理等功能。

mcp-github-project-manager