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 integration with GitHub's Projects v2 API for Agile project management, allowing for managing GitHub Projects, Issues, and Repositories through a Model Context Protocol server.
Utilizes GraphQL for interacting with GitHub's Projects v2 API, supporting queries and mutations for projects, fields, items and other GitHub resources.

GitHub 项目 MCP 服务器

MCP（模型上下文协议）服务器，使 AI 代理能够使用 GitHub 项目创建和管理基于 Agile Sprint 的项目。

特征

GitHub Projects v2 API ：全面支持 GitHub 的 GraphQL Projects v2 API
GitHub 问题：创建、阅读和更新 GitHub 问题
GitHub 存储库：获取存储库详细信息
类型安全：使用 TypeScript 构建，以实现最大程度的类型安全

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 GitHub Projects MCP Server：

npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude

用法

手动安装

克隆此存储库：
git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git cd mcp-github-projects
安装依赖项：
bun install
使用您的 GitHub 令牌创建一个.env文件：
GITHUB_TOKEN=your_github_personal_access_token GITHUB_OWNER=your_github_username
构建服务器：
bun run build
使用以下设置配置您的 MCP 客户端：

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

环境变量

GITHUB_TOKEN ：具有适当权限的 GitHub 个人访问令牌
GITHUB_OWNER ：GitHub 用户名或组织名称

GitHub 令牌权限

此 MCP 服务器需要具有以下权限的 GitHub 个人访问令牌（经典）：

project ——完全控制项目
read:project项目的读取权限
repo - 完全控制私有存储库
repo:status - 访问提交状态
repo_deployment - 访问部署状态
public_repo - 访问公共存储库
repo:invite - 访问存储库邀请
security_events - 读取和写入安全事件

发展

命令

构建： bun run build
生成 GraphQL 类型： bun run graphql-codegen

项目结构

该项目是 GitHub GraphQL API 的 MCP 服务器，专注于项目 V2 的操作。代码库通过 GraphQL 提供对 GitHub 项目功能的类型化访问。

可用操作

项目

创建、读取、更新和删除 GitHub 项目
管理项目字段、项目和状态更新
将草稿问题转换为实际问题
存档和取消存档项目

问题

获取问题详细信息
将问题添加到项目

存储库

获取存储库信息

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

使用户能够通过自然语言与 GitHub 的 Projects v2 API 进行交互，实现敏捷项目管理，支持存储库详细信息、问题跟踪和项目板管理操作。

Related Resources

Reddit Discussion about this server