GitHub Projects MCP Server

GitHub Projects MCP Server

使用户能够通过自然语言与 GitHub 的 Projects v2 API 交互,以进行敏捷项目管理,支持仓库详情、问题跟踪和项目看板管理操作。

版本控制
开发者工具
访问服务器

Tools

create-issue

Create a new GitHub issue

update-issue

Update an existing GitHub issue

get-repository

Get a GitHub repository by owner and name

list-repositories

List repositories for a user

get-project

Get a GitHub Project by ID

list-projects

List GitHub Projects for a user

get-project-columns

Get status columns for a GitHub Project

get-project-fields

Get fields for a GitHub Project

get-project-items

Get items (issues) from a GitHub Project

create-project-item

Add an issue or PR to a GitHub Project

update-project-item-field

Update a field value for a project item

create-project

Create a new GitHub Project

update-project

Update an existing GitHub Project

delete-project

Delete a GitHub Project

copy-project

Copy a GitHub Project

add-draft-issue

Add a draft issue to a GitHub Project

convert-draft-issue

Convert a draft issue to a regular issue

add-item-to-project

Add an existing issue or PR to a GitHub Project

update-item-position

Update the position of an item in a GitHub Project

delete-project-item

Remove an item from a GitHub Project

create-project-field

Create a new field in a GitHub Project

update-project-field

Update a field in a GitHub Project

delete-project-field

Delete a field from a GitHub Project

update-project-status

Update the status of a GitHub Project

archive-project-item

Archive an item in a GitHub Project

unarchive-project-item

Unarchive an item in a GitHub Project

clear-item-field-value

Clear a field value for an item in a GitHub Project

mark-project-as-template

Mark a GitHub Project as a template

unmark-project-as-template

Unmark a GitHub Project as a template

get-issue

Get a GitHub issue by number

list-issues

List issues for a repository

README

GitHub Projects MCP 服务器

smithery badge

一个 MCP (模型上下文协议) 服务器,使 AI 代理能够使用 GitHub Projects 创建和管理基于 Agile Sprint 的项目。

<a href="https://glama.ai/mcp/servers/86aw338aa5"> <img width="380" height="200" src="https://glama.ai/mcp/servers/86aw338aa5/badge" alt="GitHub Projects Server MCP server" /> </a>

特性

  • GitHub Projects v2 API: 完全支持 GitHub 的 GraphQL Projects v2 API
  • GitHub Issues: 创建、读取和更新 GitHub issues
  • GitHub Repositories: 获取仓库详情
  • 类型安全: 使用 TypeScript 构建,以实现最大程度的类型安全

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 GitHub Projects MCP 服务器:

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

使用

手动安装

  1. 克隆此仓库:

    git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
    cd mcp-github-projects
    
  2. 安装依赖项:

    bun install
    
  3. 创建一个包含您的 GitHub 令牌的 .env 文件:

    GITHUB_TOKEN=your_github_personal_access_token
    GITHUB_OWNER=your_github_username
    
  4. 构建服务器:

    bun run build
    
  5. 使用以下设置配置您的 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 Personal Access Token
  • GITHUB_OWNER: GitHub 用户名或组织名称

GitHub 令牌权限

此 MCP 服务器需要一个具有以下权限的 GitHub Personal Access Token (classic):

  • 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 服务器,重点是 Project V2 操作。 该代码库通过 GraphQL 提供对 GitHub 项目功能的类型化访问。

可用操作

项目

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

Issues

  • 获取 issue 详情
  • 将 issue 添加到项目

仓库

  • 获取仓库信息

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
Gitingest-MCP

Gitingest-MCP

一个用于 gitingest 的 MCP 服务器。它允许像 Claude Desktop、Cursor、Cline 等 MCP 客户端快速提取关于 Github 仓库的信息,包括仓库摘要、项目目录结构、文件内容等。

精选
本地
Python
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python