Mcp Server Github

mcp-server-github

GitHub API と連携するためのツールを提供する MCP（Model Context Protocol）サーバーです。リポジトリ、イシュー、プルリクエスト、コード検索、ブランチ、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