GitHub MCP Serverのセットアップ方法 (2026年版)
Model Context Protocol を介して GitHub を AI アシスタントに接続する
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
GitHub MCP サーバーのセットアップ方法 (2026年版)
Model Context Protocol (MCP) は、AI アシスタントが標準化されたインターフェースを介して外部のツールやサービスとやり取りすることを可能にします。GitHub MCP サーバーは、最も便利な統合機能の1つです。これを使用することで、Claude、Cursor、その他の MCP 対応クライアントなどの AI アシスタントが、自然言語を通じて Issue の作成、Pull Request のレビュー、コード検索、リポジトリ管理などを実行できるようになります。
このガイドでは、GitHub MCP サーバーをゼロからセットアップし、AI ツールに接続する手順を説明します。
GitHub MCP サーバーとは?
GitHub MCP サーバーは、GitHub の API を AI アシスタントが呼び出し可能なツールのセットとして公開します。GitHub の UI を手動で操作したり API コールを記述したりする代わりに、AI アシスタントに次のように伝えることができます。
- 「話し合ったログインのバグについて Issue を作成して」
- 「このリポジトリのオープンな Pull Request をレビューして」
- 「非推奨の
handleAuth関数を参照しているすべてのファイルを検索して」 - 「ブランチを作成し、Issue #42 の修正をプッシュして」
MCP サーバーは、これらの自然言語によるリクエストを GitHub API コールに変換し、結果を AI に返します。
利用可能なツール
GitHub MCP サーバーは以下の機能を提供します。
| ツールカテゴリ | 操作内容 |
|---|---|
| Repositories | リポジトリの作成、フォーク、一覧表示、検索 |
| Issues | Issue の作成、読み取り、更新、コメント、一覧表示、検索 |
| Pull Requests | PR の作成、レビュー、マージ、一覧表示、diff の取得 |
| Branches | ブランチの作成、一覧表示、削除 |
| Files | ファイル内容の読み取り、作成、更新 |
| Code Search | リポジトリを跨いだコード検索 |
| Commits | コミット一覧の表示、コミット詳細の取得 |
| Actions | ワークフロー実行一覧の表示、ステータスの取得 |
| Users | ユーザープロファイルの取得、コラボレーターの一覧表示 |
事前準備
| 要件 | 詳細 |
|---|---|
| GitHub アカウント | 無料または有料 |
| GitHub Personal Access Token | Fine-grained または Classic |
| Node.js | v18 以上 |
| MCP 対応クライアント | Claude Desktop, Claude Code, Cursor など |
ステップ 1: GitHub Personal Access Token の作成
MCP サーバーが GitHub リソースにアクセスするためのトークンが必要です。
Fine-Grained Token (推奨)
- github.com/settings/tokens にアクセスします。
- Fine-grained tokens の下の Generate new token をクリックします。
- 分かりやすい名前を設定します(例: "MCP Server Access")。
- 有効期限を設定します(90日推奨、またはカスタム)。
- Repository access で以下を選択します:
- 全てにアクセスする場合は All repositories
- 特定のリポジトリに限定する場合は Only select repositories
- Permissions で以下を許可します:
| 権限 | アクセスレベル |
|---|---|
| Contents | Read and write |
| Issues | Read and write |
| Pull requests | Read and write |
| Metadata | Read-only |
| Actions | Read-only |
| Commit statuses | Read-only |
- Generate token をクリックし、すぐにトークンをコピーします。
# トークンを環境変数として保存する
export GITHUB_PERSONAL_ACCESS_TOKEN="github_pat_your-token-here"
Classic Token (より簡易的)
Fine-grained トークンが複雑に感じる場合は、Classic トークンを使用してください:
- github.com/settings/tokens にアクセスします。
- Generate new token (classic) をクリックします。
- スコープを選択します:
repo,read:org,read:user。 - 生成してコピーします。
ステップ 2: GitHub MCP サーバーのインストール
公式の GitHub MCP サーバーは GitHub(以前は Anthropic/コミュニティ)によってメンテナンスされています。環境に合わせてインストールしてください。
オプション A: npx を使用する (インストール不要)
最も簡単な方法です。npx で直接実行します:
npx -y @modelcontextprotocol/server-github
これにより、必要に応じてサーバーがダウンロードされ実行されます。グローバルインストールは不要です。
オプション B: グローバルインストール
npm install -g @modelcontextprotocol/server-github
オプション C: Docker
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN="your-token" \
ghcr.io/modelcontextprotocol/server-github
ステップ 3: Claude Desktop への接続
Claude Desktop (Anthropic のスタンドアロンアプリ) を使用している場合は、設定ファイルに GitHub MCP サーバーを追加します。
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_your-token-here"
}
}
}
}
設定を保存したら Claude Desktop を再起動してください。チャット入力欄にツールが利用可能であることを示すハンマーのアイコンが表示されるはずです。
接続の確認
Claude に「私の GitHub リポジトリをリストアップして」と頼んでみてください。MCP サーバーが正しく接続されていれば、Claude は GitHub ツールを呼び出してリポジトリ一覧を返します。
ステップ 4: Claude Code への接続
Claude Code は MCP サーバーをネイティブでサポートしています。プロジェクト設定またはグローバル設定に GitHub MCP サーバーを追加します。
プロジェクトレベルの設定
プロジェクトのルートに .mcp.json を作成または編集します:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_your-token-here"
}
}
}
}
グローバル設定
claude mcp add github -- npx -y @modelcontextprotocol/server-github
または ~/.claude/settings.json を編集します:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_your-token-here"
}
}
}
}
テスト
claude
> list open issues on owner/repo-name
> create a branch called fix-auth-bug from main
> show me the diff for PR #42
ステップ 5: Cursor への接続
Cursor は設定から MCP サーバーをサポートしています。GitHub MCP サーバーを追加する手順:
- Cursor の設定 (Cmd+, / Ctrl+,) を開きます。
- "MCP" を検索するか、Features > MCP Servers に移動します。
- Add MCP Server をクリックし、以下を入力します:
{
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_your-token-here"
}
}
}
あるいは、プロジェクト内に .cursor/mcp.json ファイルを作成します:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_your-token-here"
}
}
}
}
実践的なユースケース
1. AI によるコードレビュー
AI アシスタントにオープンな Pull Request のレビューを依頼します:
プロンプト: "owner/my-repo の PR #15 をレビューして。セキュリティの問題、
パフォーマンスの問題、コードスタイルをチェックして、要約コメントを残して。"
AI は MCP サーバー経由で PR の diff を読み取り、変更を分析して、GitHub 上に直接レビューコメントを投稿できます。
2. Issue 管理
自然言語の説明から Issue を作成します:
プロンプト: "owner/my-repo に 'モバイルデバイスでのログインタイムアウト' というタイトルの
Issue を作成して。'bug' と 'priority: high' のラベルを付けて。説明欄には、
iOS Safari のユーザーが OAuth リダイレクト中に 30 秒のタイムアウトが発生していると書いて。"
3. リポジトリを跨いだコード検索
組織のリポジトリ全体から特定のパターンを検索します:
プロンプト: "組織内のすべてのリポジトリで、非推奨の 'legacyAuth()' 関数の使用箇所を
検索して。ファイル名と行番号をリストアップして。"
4. ブランチ作成と PR 作成の自動化
Claude Code のコーディング能力と GitHub MCP を組み合わせます:
プロンプト: "'fix-memory-leak' というブランチを作成し、src/cache.ts で接続が
解放されていないメモリリークを修正して。修正をコミットしてブランチをプッシュし、
変更内容を説明した PR を作成して。"
5. リリースノートの生成
プロンプト: "owner/my-repo の最新のリリースタグ以降にマージされたすべての PR を確認して。
新機能、バグ修正、改善のグループごとにリリースノートを生成して。"
セキュリティのベストプラクティス
トークンのスコープ設定
最小限の権限を持つ Fine-grained トークンを使用してください。リポジトリの読み取りだけで済む場合は、書き込み権限を付与しないでください。
環境変数
Git にコミットされる可能性のある設定ファイルにトークンをハードコードしないでください:
# .gitignore に追加
echo ".mcp.json" >> .gitignore
# 代わりに環境変数を使用する
export GITHUB_PERSONAL_ACCESS_TOKEN="your-token"
その後、設定で環境変数を参照します:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}
トークンのローテーション
トークンに有効期限を設定し、定期的に更新してください。GitHub の Fine-grained トークンはカスタムの有効期限をサポートしています。
操作ログ(Audit Logging)
GitHub の Audit Log はすべての API アクセスを記録します。定期的に監視し、MCP サーバーが意図したリソースのみにアクセスしていることを確認してください。
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| "Bad credentials" エラー | トークンを再生成し、設定を更新してください |
| サーバーが起動しない | Node.js v18 以上がインストールされているか確認してください |
| ツールが表示されない | 設定変更後、MCP クライアントを再起動してください |
| レート制限 (Rate limiting) | GitHub は認証済みユーザーに対し1時間あたり5,000リクエストを許可しています。クエリの頻度を下げてください |
| タイムアウトエラー | MCP サーバーにはデフォルトのタイムアウトがあります。大規模なリポジトリの場合、サーバー設定でタイムアウトを増やしてください |
| 権限不足 (Permission denied) | トークンにその操作に必要なスコープがあるか確認してください |
よくある質問
GitHub MCP サーバーは公式のものですか?
@modelcontextprotocol/server-github パッケージは、MCP GitHub 組織で管理されている公式の MCP サーバーコレクションの一部です。GitHub 自身も独自の公式 MCP サーバーをリリースしています。
GitHub Enterprise で動作しますか?
はい。GITHUB_API_URL 環境変数を Enterprise インスタンスの URL に設定してください。
複数の人で同じ MCP サーバーを共有できますか? 各個人が自身のトークンを持つ必要があります。MCP サーバーは各開発者のローカルマシン上で動作します。
レート制限についてはどうですか? 認証済みの GitHub API リクエストは1時間あたり5,000回までです。通常の MCP の利用でこの制限に達することは稀です。
GitLab や Bitbucket で使えますか? いいえ。このサーバーは GitHub 専用です。GitLab や Bitbucket 用の MCP サーバーは別途存在します。
まとめ
GitHub MCP サーバーは、AI アシスタントを GitHub のパワーユーザーに変えてくれます。AI ツール、GitHub UI、ターミナルの間を行き来する代わりに、Issue の管理、PR のレビュー、コード検索、ブランチ作成のすべてを自然言語の対話を通じて行うことができます。
セットアップは5分もかからず、生産性の向上はすぐに実感できるでしょう。一度 AI による GitHub 管理に慣れてしまうと、手動のワークフローに戻るのは非常に遅く感じられるはずです。
AI 生成メディアを含むプロジェクトを構築されている場合は、Hypereal AI を無料でお試しください。クレジットカードは不要です。その API は、画像や動画生成機能のための GitHub ベースのワークフローとシームレスに統合できます。
