Back to MCP directory
publicPublicdnsLocal runtime

github-mcp

一个基于TypeScript的GitHub管理MCP服务器,提供组织、仓库和协作者的管理功能

article

README

🚀 GitHub 管理器 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器,提供了一系列通过 GitHub API 管理 GitHub 组织、仓库和协作者的工具,能有效提升管理效率。

🚀 快速开始

本 GitHub 管理器 MCP 服务器可帮助你通过 GitHub API 便捷管理组织、仓库和协作者。以下是使用前的准备步骤。

✨ 主要特性

GitHub 管理工具

  • list_orgs:列出已认证用户所属的 GitHub 组织
  • list_repos:在指定组织中列出仓库
  • create_repo:创建组织中的新仓库
  • add_collaborator:添加仓库协作者
  • update_repo_settings:更新仓库设置

📦 安装指南

安装依赖

npm install

构建项目

npm run build

带自动重建的开发模式

npm run watch

测试

运行单元测试

npm test

运行带覆盖范围的测试

npm run test:coverage

📚 详细文档

配置

环境变量

  • GITHUB_TOKEN:具有所需作用域的 GitHub 个人访问令牌

MCP 服务器安装

要与 Claude Desktop 使用,请添加以下配置:

  • 在 MacOS 上:~/Library/Application Support/Claude/claude_desktop_config.json
  • 在 Windows 上:%APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "github-manager": {
      "command": "/path/to/github-manager/build/index.js",
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

调试

我们推荐使用 MCP Inspector,它作为包脚本可用:

npm run inspector

Inspector 将提供一个访问调试工具的 URL,在你的浏览器中打开即可。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client