github

GitHub MCP サーバー

GitHub 操作用の Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、AI アシスタントは標準化されたインターフェースを通じて GitHub リポジトリを操作できます。

機能

• 🔍 プルリクエストの一覧表示と閲覧 - フィルタリングオプションを使用して PR を確認できます
• 📋 Issue の一覧表示と閲覧 - ラベル、担当者、コメントを含む Issue にアクセスできます
• 📊 リポジトリ情報 - リポジトリの統計情報とメタデータを取得できます
• 🔎 コード検索 - GitHub リポジトリ全体からコードを検索できます

インストール

npm install -g @bountyclaw/mcp-github-server

設定

GitHub トークンを環境変数として設定します。

export GITHUB_TOKEN=your_github_token_here

または、クライアントをプログラムから作成する際に渡すこともできます。

Claude Code での使用

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@bountyclaw/mcp-github-server"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

利用可能なツール

1. github_pr_list

リポジトリのプルリクエストを一覧表示します。

入力：

• owner（string、必須）：リポジトリのオーナー
• repo（string、必須）：リポジトリ名
• state（enum、任意）：状態で絞り込み（open、closed、all）
• head（string、任意）：ヘッドブランチで絞り込み
• base（string、任意）：ベースブランチで絞り込み
• sort（enum、任意）：並べ替えフィールド
• direction（enum、任意）：並べ替え順
• per_page（number、任意）：1 ページあたりの結果数（最大 100）
• page（number、任意）：ページ番号

2. github_pr_view

特定のプルリクエストの詳細を表示します。

入力：

• owner（string、必須）：リポジトリのオーナー
• repo（string、必須）：リポジトリ名
• pull_number（number、必須）：PR 番号
• include_diff（boolean、任意）：差分の内容を含める

3. github_issue_list

リポジトリの Issue を一覧表示します。

入力：

• owner（string、必須）：リポジトリのオーナー
• repo（string、必須）：リポジトリ名
• state（enum、任意）：状態で絞り込み
• labels（string、任意）：カンマ区切りのラベル名
• assignee（string、任意）：担当者で絞り込み
• creator（string、任意）：作成者で絞り込み
• sort（enum、任意）：並べ替えフィールド
• direction（enum、任意）：並べ替え順
• per_page（number、任意）：1 ページあたりの結果数
• page（number、任意）：ページ番号

4. github_issue_view

特定の Issue の詳細を表示します。

入力：

• owner（string、必須）：リポジトリのオーナー
• repo（string、必須）：リポジトリ名
• issue_number（number、必須）：Issue 番号
• include_comments（boolean、任意）：コメントを含める

5. github_repo_info

リポジトリの情報と統計を取得します。

入力：

• owner（string、必須）：リポジトリのオーナー
• repo（string、必須）：リポジトリ名

6. github_search_code

GitHub 全体からコードを検索します。

入力：

• query（string、必須）：検索クエリ（GitHub コード検索構文）
• sort（enum、任意）：並べ替えフィールド（indexed、best-match）
• order（enum、任意）：並べ替え順
• per_page（number、任意）：1 ページあたりの結果数
• page（number、任意）：ページ番号

クエリの例

"List open PRs in facebook/react"
"Show me issue #123 in microsoft/vscode"
"Get info about the kubernetes/kubernetes repo"
"Search for 'useEffect' in TypeScript files"

開発

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Format
npm run format

テスト

このプロジェクトには、カバレッジ 90％以上の包括的な単体テストが含まれています。

• GitHub API クライアントのテスト
• 6 つすべてのツールを対象としたツールハンドラーのテスト
• エラー処理のテスト
• 入力検証のテスト

npm test

ライセンス

MIT ライセンスの詳細については、LICENSE ファイルを参照してください。

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

---

BountyClaw が 🦞 を使って開発しました