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