GitHub MCP 服务器

与 GitHub API 交互的模型上下文协议 (MCP) 服务器。

功能

工具

• list_user_repos：列出认证用户的所有仓库

  • 参数：
    • type（可选）："owner"、"all" 或 "member"（默认： "owner"）
    • sort（可选）："created"、"updated"、"pushed" 或 "full_name"（默认： "full_name"）
    • direction（可选）："asc" 或 "desc"（默认： "asc"）
    • per_page（可选）：每页结果数量（默认：30，最大：100）
    • page（可选）：页码（默认：1）

• get_repo：获取特定仓库的详细信息

  • 参数：
    • repo（必需）：仓库名称
    • owner（可选）：账户所有者。如果未提供，则使用认证用户。

• create_repo：创建一个新的仓库

  • 参数：
    • name（必需）：仓库名称
    • description（可选）：简短描述
    • private（可选）：是否为私有仓库（默认：false）
    • auto_init（可选）：创建初始提交并带有空 README 文件（默认：false）

• create_commit：创建一个新的包含文件更改的提交

  • 参数：
    • repo（必需）：仓库名称
    • owner（可选）：账户所有者。如果未提供，则使用认证用户。
    • branch（可选）：分支名称（默认： "main"）
    • message（必需）：提交信息
    • files（必需）：包含在提交中的文件数组
      • 每个文件需要：
        • path：相对于仓库根目录的文件路径
        • content：文件内容

• push：将更改推送到远程仓库

  • 参数：
    • repo（必需）：仓库名称
    • owner（可选）：账户所有者。如果未提供，则使用认证用户。
    • branch（可选）：分支名称（默认： "main"）

• pull：从远程仓库拉取更改

  • 参数：
    • repo（必需）：仓库名称
    • owner（可选）：账户所有者。如果未提供，则使用认证用户。
    • branch（必需）：分支名称

需求

• Node.js 18+ 版本
• 具备适当权限的 GitHub 个人访问令牌
• 设置 GITHUB_TOKEN 环境变量

安装

npm install
npm run build

配置

将你的 GitHub 令牌设置为环境变量：

export GITHUB_TOKEN=your_token_here

使用方法

运行服务器：

npm start

开发

带有自动重建功能的开发：

npm run watch

调试

使用 MCP 检查器：

npm run inspector