返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端