Mcp Server Github

mcp-server-github

一个 MCP（Model Context Protocol）服务，提供用于与 GitHub API 交互的工具，包括仓库、议题、拉取请求、代码搜索、分支和 GitHub Actions 工作流。

架构

graph TB
    subgraph Client
        style Client fill:#4A90D9,stroke:#2E6BA6,color:#FFFFFF
        MCP_Client["MCP Client"]
    end

    subgraph Server["mcp-server-github"]
        style Server fill:#2ECC71,stroke:#1A9B52,color:#FFFFFF
        Index["index.ts<br/>MCP Server Entry"]
        subgraph Tools
            style Tools fill:#F39C12,stroke:#C67D0A,color:#FFFFFF
            T1["list_repos"]
            T2["create_issue"]
            T3["list_pull_requests"]
            T4["get_file_contents"]
            T5["search_code"]
            T6["create_branch"]
            T7["list_workflows"]
            T8["get_workflow_runs"]
        end
    end

    subgraph External["GitHub API"]
        style External fill:#24292E,stroke:#1B1F23,color:#FFFFFF
        Repos["Repos API"]
        Issues["Issues API"]
        PRs["Pull Requests API"]
        Contents["Contents API"]
        Search["Search API"]
        Git["Git Refs API"]
        Actions["Actions API"]
    end

    MCP_Client -- "stdio transport" --> Index
    Index --> T1 & T2 & T3 & T4 & T5 & T6 & T7 & T8
    T1 --> Repos
    T2 --> Issues
    T3 --> PRs
    T4 --> Contents
    T5 --> Search
    T6 --> Git
    T7 --> Actions
    T8 --> Actions

安装

npm install
npm run build

配置

变量	描述	必需
GITHUB_TOKEN	GitHub 个人访问令牌	是

用法

独立运行

GITHUB_TOKEN=ghp_xxxx npm start

开发

npm run dev

Docker

docker build -t mcp-server-github .
docker run -e GITHUB_TOKEN=ghp_xxxx mcp-server-github

MCP 客户端配置

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxx"
      }
    }
  }
}

工具参考

工具	描述	参数
list_repos	列出仓库	owner?、type?、sort?
create_issue	创建议题	owner、repo、title、body?、labels?、assignees?
list_pull_requests	列出拉取请求	owner、repo、state?、sort?
get_file_contents	获取文件内容	owner、repo、path、ref?
search_code	搜索代码	query、per_page?
create_branch	创建分支	owner、repo、branch、from_branch?
list_workflows	列出工作流	owner、repo
get_workflow_runs	获取工作流运行记录	owner、repo、workflow_id、status?

许可证

MIT