GitHub MCP 服务器

一个提供GitHub集成功能的模型上下文协议（MCP）服务器。此服务器通过MCP工具实现与GitHub仓库的交互，支持仓库管理、文件操作和提交处理等功能。

特性

• 账户管理和身份验证
• 仓库创建和管理
• 文件操作（读取、写入、推送、拉取）
• 提交操作
• 目录同步
• 仓库比较和差异分析

安装

npm install @modelcontextprotocol/server-github

配置

将服务器添加到您的MCP设置文件（cline_mcp_settings.json）中：

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/path/to/github-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN_1": "your-github-token",
        "GITHUB_OWNER_1": "your-github-username"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

可用工具

账户管理

list_accounts

列出服务器中配置的GitHub账户。

select_account

选择用于后续操作的GitHub账户。

仓库管理

create_repository

创建新的GitHub仓库。

{
  owner?: string;        // 仓库所有者（可选，若已选账户）
  name: string;          // 仓库名称
  description: string;   // 仓库描述
  private?: boolean;     // 是否为私有仓库
}

clone_repository

将GitHub仓库克隆到本地目录。

{
  owner?: string;    // 仓库所有者
  repo: string;      // 仓库名称
  branch?: string;   // 分支名称（默认：main）
  outputDir: string; // 克隆到的本地目录
}

rename_repository

重命名现有GitHub仓库。

{
  owner?: string;    // 仓库所有者
  repo: string;      // 当前仓库名称
  new_name: string;  // 新仓库名称
}

文件操作

push_file

将文件推送到GitHub仓库。

{
  owner?: string;     // 仓库所有者
  repo: string;       // 仓库名称
  path: string;       // 仓库中的目标路径
  message: string;    // 提交信息
  sourcePath: string; // 待推送的本地文件路径
}

pull_file

从GitHub仓库拉取文件。

{
  owner?: string;     // 仓库所有者
  repo: string;       // 仓库名称
  path: string;       // 仓库中的文件路径
  outputDir: string;  // 拉取到的本地目录
}

delete_file

从GitHub仓库删除文件。

{
  owner?: string;     // 仓库所有者
  repo: string;       // 仓库名称
  path: string;       // 仓库中的文件路径
}

提交操作

create_commit

向GitHub仓库创建提交。

{
  owner?: string;         // 仓库所有者
  repo: string;           // 仓库名称
  branch: string;         // 分支名称
  changes: {              // 待提交的更改列表
    path: string;        // 文件路径
    content: string;      // 文件内容
    mode?: string;       // 文件模式（可选）
  }[]
}

开发

依赖项安装

使用以下命令安装开发依赖项：

npm install

构建

构建项目以生成发行版本：

npm run build

环境变量

• GITHUB_TOKEN_<N>：用于身份验证的GitHub个人访问令牌。
• GITHUB_OWNER_<N>：GitHub用户名或组织名称。

许可证

本项目采用MIT许可证。