GitHub MCP Server

GitHub MCP 服务

用于与 GitHub API 交互的模型上下文协议服务。

功能

工具

• 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 Inspector：

npm run inspector