github-mcp

モード：認知／プロンプト駆動型 — 単独で実行するユーティリティスクリプトはありません。エージェントのコンテキストで使用してください。

GitHub スキル

概要

このスキルでは、最適なコンテキスト使用のために段階的な情報開示を行う、公式の GitHub MCP サーバーを利用できます。

コンテキストの節約：約 95％削減

• MCP モード：常時読み込まれるトークン数は約 50,000（80 以上のツール）
• スキルモード：メタデータ約 500 トークン＋必要に応じた読み込み

要件

• Docker がインストールされ、実行中であること
• GITHUB_PERSONAL_ACCESS_TOKEN 環境変数が設定されていること

ツールセット

サーバーは 19 のツールセットにわたり、80 以上のツールを提供します。

ツールセット	説明
actions	ワークフローの管理、実行、ジョブ、アーティファクト
code_security	スキャンアラート、コード分析
discussions	フォーラムでのやり取り
gists	コードスニペットの管理
issues	Issue の作成、更新、コメント
labels	ラベルの管理とフィルタリング
projects	GitHub Projects ボードの管理
pull_requests	PR の作成、レビュー、マージ
repos	コード検索、コミット、リリース、ブランチ
users	ユーザーの検索と管理
orgs	組織とチームの管理
notifications	通知の管理
secret_scanning	シークレットスキャンのアラート
context	ユーザーに関するコンテキスト

クイックリファレンス

GitHub の操作には gh CLI を使用します。

# Get repository info
gh repo view anthropics/claude-code

# List issues
gh issue list --repo anthropics/claude-code

# Search code
gh search code "language:python MCP"

# Create issue
gh issue create --repo me/myrepo --title "Bug" --body "Description"

# List pull requests
gh pr list --repo anthropics/claude-code

よく使うツール（デフォルトのツールセット：40 ツール）

リポジトリの操作

• search_repositories - リポジトリを検索
• create_repository - 新しいリポジトリを作成
• fork_repository - リポジトリをフォーク
• list_commits - リポジトリのコミット一覧を取得
• get_commit - コミットの詳細を取得
• get_file_contents - リポジトリからファイルの内容を取得
• create_or_update_file - ファイルを作成または更新
• delete_file - ファイルを削除
• push_files - 複数のファイルをプッシュ
• search_code - GitHub 全体からコードを検索
• list_branches - リポジトリのブランチ一覧を取得
• create_branch - 新しいブランチを作成
• list_tags - リポジトリのタグ一覧を取得
• get_tag - タグの詳細を取得
• list_releases - リリース一覧を取得
• get_latest_release - 最新のリリースを取得
• get_release_by_tag - タグからリリースを取得

Issue の操作

• list_issues - リポジトリの Issue 一覧を取得
• issue_read - Issue の詳細を読み取る
• issue_write - Issue を作成／更新
• add_issue_comment - Issue にコメントを追加
• search_issues - Issue を検索
• list_issue_types - Issue の種類を一覧表示（組織向け）
• get_label - ラベルの詳細を取得
• sub_issue_write - サブ Issue を管理
• assign_copilot_to_issue - Copilot を Issue に割り当て

プルリクエストの操作

• list_pull_requests - リポジトリのプルリクエスト一覧を取得
• pull_request_read - PR の詳細を読み取る
• create_pull_request - 新しい PR を作成
• update_pull_request - PR を更新
• update_pull_request_branch - PR のブランチを更新
• merge_pull_request - PR をマージ
• search_pull_requests - プルリクエストを検索
• pull_request_review_write - PR レビューを作成／送信
• add_comment_to_pending_review - 保留中のレビューにコメントを追加
• request_copilot_review - Copilot にレビューを依頼

ユーザーとチームの操作

• get_me - 現在認証されているユーザーを取得
• search_users - ユーザーを検索
• get_teams - 組織のチーム一覧を取得
• get_team_members - チームメンバーを取得

設定

このスキルでは、Docker を使用して公式の GitHub MCP サーバーを実行します。

• イメージ：ghcr.io/github/github-mcp-server
• 認証：GITHUB_PERSONAL_ACCESS_TOKEN 環境変数

環境変数

変数	必須	説明
GITHUB_PERSONAL_ACCESS_TOKEN	はい	認証に使用する GitHub PAT
GITHUB_HOST	いいえ	GitHub Enterprise 用（デフォルト: github.com）
GITHUB_TOOLSETS	いいえ	有効にするツールセット（カンマ区切り）
GITHUB_READ_ONLY	いいえ	読み取り専用モードにするには 1 を設定します

ツールセットの制限

MCP の使用時は、環境変数でツールセットを設定します。

# Only repos and issues
GITHUB_TOOLSETS=repos,issues

# Only pull requests and code security
GITHUB_TOOLSETS=pull_requests,code_security

エラー処理

操作に失敗した場合：

1. Docker が実行中であることを確認します：docker ps
2. GitHub トークンが設定されていることを確認します：echo $GITHUB_PERSONAL_ACCESS_TOKEN
3. トークンに操作に必要な権限があることを確認します
4. gh auth status を使用して認証を確認します

関連情報

• GitHub 公式 MCP サーバー：https://github.com/github/github-mcp-server
• GitHub API ドキュメント：https://docs.github.com/en/rest

メモリプロトコル（必須）

開始前： .claude/context/memory/learnings.md を読みます

完了後：

• 新しいパターン → .claude/context/memory/learnings.md
• 見つかった問題 → .claude/context/memory/issues.md
• 決定事項 → .claude/context/memory/decisions.md

中断を想定してください。メモリに記録されていなければ、実行されていないものとみなします。