MCP GitHub connector

github mcp服务器

使用自然语言与GitHub对话——由模型上下文协议提供支持

______________________________________________________________________

github-mcp-server 是一个 模型上下文协议（MCP） 服务器，该服务器将GitHub API公开为一组AI调用工具。将其连接到Claude、Cursor、Windsurf或任何兼容MCP的客户端，并开始使用纯英文管理您的存储库、问题、提取请求、分支和文件-无需GitHub UI，无需手动API调用。

“列出我的未决问题”•“创建从功能分支到主分支的PR”•“过去5次提交中有什么变化？”

______________________________________________________________________

运作原理

You (natural language prompt)
        │
        ▼
AI Client  ─────────────────────────────────────────  Claude Desktop
(MCP host)                                            Cursor / Windsurf
        │                                             VS Code + Copilot
        │  MCP protocol over stdio
        ▼
github-mcp-server  (this project, runs locally)
        │
        │  GitHub REST API  (authenticated with your token)
        ▼
GitHub

服务器作为 本地子流程 当你开始对话时，你的AI客户端会自动生成。它通过以下方式进行通信 标准 --没有端口，没有云服务，没有代理。您的GitHub个人访问令牌永远不会离开您的计算机。

______________________________________________________________________

特性

8个类别的26个工具：

• 仓库 --列出、检查、创建、分叉、删除
• 问题 --列表、阅读、创建、更新、评论
• 拉取请求 --列出、检查、打开、合并
• 文件和内容 --读取文件、列出目录、使用提交进行写入和删除
• 分支 --列出、检查、创建、删除
• 提交 --浏览历史记录，检查差异和统计数据
• 搜索 --具有完整GitHub搜索语法的存储库、代码、问题和PR
• 用户 --您的个人资料或任何公共用户

______________________________________________________________________

快速开始

1.获取GitHub个人访问令牌

首选 **** 并生成具有所需作用域的经典令牌或细粒度令牌。

2.配置您的AI客户端

克劳德桌面版 --编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

光标/风帆 --编辑 .cursor/mcp.json 或 .windsurf/mcp.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

VS代码（GitHub副本） --添加到您的 settings.json:

{
  "mcp": {
    "servers": {
      "github": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "github-mcp-server"],
        "env": {
          "GITHUB_TOKEN": "ghp_your_token_here"
        }
      }
    }
  }
}

3.重启你的AI客户端——就是这样

服务器根据需要自动启动。没有守护进程，没有后台进程。

______________________________________________________________________

安装

通过npx实现零安装 _（推荐）_

无需全局安装。您的客户端配置处理此问题：

GITHUB_TOKEN=ghp_... npx github-mcp-server

通过npm进行全局安装

npm install -g github-mcp-server
GITHUB_TOKEN=ghp_... github-mcp-server

来源

git clone https://github.com/AtlasJedi/mcp_github_connector
cd github-mcp-server
npm install
npm run build
GITHUB_TOKEN=ghp_... npm start

______________________________________________________________________

可用工具

仓库

问题

拉取请求

文件和内容

分支

提交

搜索

用户

______________________________________________________________________

示例提示

连接后，在您的AI客户端中尝试以下操作：

What are my most recently updated repositories?

Create an issue in myorg/myrepo titled "Fix the login timeout" with the label "bug"

Show me all open PRs in facebook/react

Create a pull request from feature/new-auth to main — write a description based on the branch name

What files changed in the last commit on the main branch of myorg/myrepo?

Search for TypeScript MCP server repositories sorted by stars

Create a new file at docs/guide.md in myrepo with the content "# Guide\n\nWelcome."

______________________________________________________________________

安全

• 您的令牌通过环境变量传递，除了GitHub API之外，从不在任何地方记录或传输。
• 当您的AI客户端会话结束时，服务器进程退出。
• 使用具有工作流所需最小范围的细粒度令牌。

______________________________________________________________________

贡献

欢迎发布问题和PR。

git clone https://github.com/AtlasJedi/mcp_github_connector
cd github-mcp-server
npm install
npm run dev   # runs directly with tsx, no build step needed

______________________________________________________________________

许可证

麻省理工学院©2025