github-cli-mcp-server

🚀 Everforth GitHub MCP 服务器

本 MCP 服务器主要用于将 GraphQL 请求投射到 GitHub。它能够安全处理访问令牌，避免将其直接提供给 Cursor Agent。同时，官方 MCP 无法正常使用，在使用 ProjectV2（Kanban）时，GraphQL 是必不可少的。此外，项目提供了公共镜像，只需简单设置即可使用，还提供了 Dockerfile，方便用户自定义构建。

🚀 快速开始

直接使用公共镜像

在 Cursor 的 mcp.json 文件中添加以下 github-cli 部分：

• 将 env 中的 <PERSONAL_ACCESS_TOKEN> 替换为您自己的 GitHub 访问令牌。
• 重启 Cursor。
• 根据需要在 Rules 中添加指令，可参考 请将 <> 包围的 Owner 名称和 Repository 名称替换为您的环境中的实际名称。

{
  "mcpServers": {
    "github-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ikutani41/github-cli-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<PERSONAL ACCESS TOKEN HERE>"
      }
    }
  }
}

自行构建使用

• 运行 npm install。
• 执行 docker build -t {hoge}/github-cli-mcp-server -f Dockerfile .

✨ 主要特性

• 安全处理令牌：避免将 GitHub 访问令牌直接提供给 Cursor Agent，增强安全性。
• GraphQL 支持：解决官方 MCP 不可用问题，支持 ProjectV2（Kanban）使用 GraphQL。
• 使用便捷：提供公共镜像，简单设置即可使用。
• 可自定义：提供 Dockerfile，方便用户自定义构建。

📦 安装指南

直接使用公共镜像

按照上述“快速开始”中“直接使用公共镜像”的步骤操作即可。

自行构建

1. 运行 npm install 安装依赖。
2. 执行 docker build -t {hoge}/github-cli-mcp-server -f Dockerfile . 构建镜像。

💻 使用示例

基础用法

在 mcp.json 文件中添加配置：

{
  "mcpServers": {
    "github-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ikutani41/github-cli-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<PERSONAL ACCESS TOKEN HERE>"
      }
    }
  }
}

然后按照步骤替换令牌、重启 Cursor 和添加指令。

高级用法

自行构建镜像时，可根据需求修改 Dockerfile 进行自定义构建，然后执行 docker build -t {hoge}/github-cli-mcp-server -f Dockerfile . 命令。