GitHub MCP Server

GitHub MCP サーバー

GitHub API 用の MCP サーバー。ファイル操作、リポジトリ管理、検索機能などを有効にします。

特徴

• 自動ブランチ作成: ファイルを作成/更新したり変更をプッシュするときに、ブランチが存在しない場合は自動的に作成されます。
• 包括的なエラー処理: 一般的な問題に対する明確なエラーメッセージ
• Git 履歴の保存: 強制プッシュなしで適切な Git 履歴を維持する操作
• バッチ操作: 単一ファイルと複数ファイルの操作の両方をサポート
• 高度な検索: コード、問題/PR、ユーザーの検索をサポート

ツール

1. create_or_update_file
   • リポジトリ内の単一のファイルを作成または更新する
   • 入力:
     • owner (文字列): リポジトリの所有者（ユーザー名または組織）
     • repo (文字列): リポジトリ名
     • path (文字列): ファイルを作成/更新するパス
     • content (文字列): ファイルの内容
     • message (文字列): コミットメッセージ
     • branch (文字列): ファイルを作成/更新するブランチ
     • sha (オプションの文字列): 置き換えられるファイルのSHA (更新用)
   • 戻り値: ファイルの内容とコミットの詳細
2. push_files
   • 1回のコミットで複数のファイルをプッシュする
   • 入力:
     • owner (文字列): リポジトリの所有者
     • repo (文字列): リポジトリ名
     • branch (文字列): プッシュ先のブランチ
     • files (配列): プッシュするファイル。 pathとcontentそれぞれ含まれます。
     • message (文字列): コミットメッセージ
   • 戻り値: 更新されたブランチ参照
3. search_repositories
   • GitHubリポジトリを検索する
   • 入力:
     • query (文字列): 検索クエリ
     • page （オプションの数値）：ページ番号
     • perPage （オプションの数値）：1ページあたりの結果数（最大100件）
   • 戻り値: リポジトリ検索結果
4. create_repository
   • 新しいGitHubリポジトリを作成する
   • 入力:
     • name (文字列): リポジトリ名
     • description （オプションの文字列）: リポジトリの説明
     • private (オプションのブール値): リポジトリを非公開にするかどうか
     • autoInit (オプションのブール値): READMEで初期化する
   • 戻り値: 作成されたリポジトリの詳細
5. get_file_contents
   • ファイルまたはディレクトリの内容を取得する
   • 入力:
     • owner (文字列): リポジトリの所有者
     • repo (文字列): リポジトリ名
     • path (文字列): ファイル/ディレクトリへのパス
     • branch （オプションの文字列）：コンテンツを取得するブランチ
   • 戻り値: ファイル/ディレクトリの内容
6. create_issue
   • 新しい問題を作成する
   • 入力:
     • owner (文字列): リポジトリの所有者
     • repo (文字列): リポジトリ名
     • title (文字列): 問題のタイトル
     • body （オプションの文字列）: 問題の説明
     • assignees （オプションの文字列[]）：割り当てるユーザー名
     • labels （オプションの文字列[]）：追加するラベル
     • milestone （オプションの番号）：マイルストーン番号
   • 返品: 作成された問題の詳細
7. create_pull_request
   • 新しいプルリクエストを作成する
   • 入力:
     • owner (文字列): リポジトリの所有者
     • repo (文字列): リポジトリ名
     • title (文字列): PRのタイトル
     • body （オプションの文字列）: PRの説明
     • head (文字列): 変更を含むブランチ
     • base (文字列): マージ先のブランチ
     • draft (オプションのブール値): ドラフト PR として作成
     • maintainer_can_modify (オプションのブール値): メンテナーによる編集を許可する
   • 戻り値: 作成されたプルリクエストの詳細
8. fork_repository
   • リポジトリをフォークする
   • 入力:
     • owner (文字列): リポジトリの所有者
     • repo (文字列): リポジトリ名
     • organization （オプションの文字列）：フォーク先の組織
   • 戻り値: フォークされたリポジトリの詳細
9. create_branch
   • 新しいブランチを作成する
   • 入力:
     • owner (文字列): リポジトリの所有者
     • repo (文字列): リポジトリ名
     • branch (文字列): 新しいブランチの名前
     • from_branch (オプションの文字列): ソースブランチ (デフォルトはリポジトリのデフォルト)
   • 戻り値: 作成されたブランチ参照
10. list_issues

• リポジトリの問題の一覧表示とフィルタリング
• 入力:
  • owner (文字列): リポジトリの所有者
  • repo (文字列): リポジトリ名
  • state （オプションの文字列）：状態（「open」、「closed」、「all」）でフィルタリング
  • labels （オプションの文字列[]）：ラベルでフィルタリング
  • sort (オプションの文字列): ('created'、'updated'、'comments') で並べ替え
  • direction （オプションの文字列）：並べ替えの方向（'asc'、'desc'）
  • since (オプションの文字列): 日付でフィルタリング (ISO 8601 タイムスタンプ)
  • page （オプションの数字）：ページ番号
  • per_page （オプションの数値）：ページあたりの結果数
• 戻り値: 問題の詳細の配列

11. update_issue

• 既存の問題を更新する
• 入力:
  • owner (文字列): リポジトリの所有者
  • repo (文字列): リポジトリ名
  • issue_number (数値): 更新する問題番号
  • title （オプションの文字列）：新しいタイトル
  • body （オプションの文字列）: 新しい説明
  • state （オプションの文字列）：新しい状態（「open」または「closed」）
  • labels （オプションの文字列[]）：新しいラベル
  • assignees （オプションの文字列[]）: 新しい担当者
  • milestone （オプションの番号）：新しいマイルストーン番号
• 返品: 問題の詳細を更新しました

12. add_issue_comment

• 問題にコメントを追加する
• 入力:
  • owner (文字列): リポジトリの所有者
  • repo (文字列): リポジトリ名
  • issue_number (数値): コメントする問題番号
  • body （文字列）: コメントテキスト
• 戻り値: 作成されたコメントの詳細

13. search_code

• GitHubリポジトリ全体でコードを検索する
• 入力:
  • q (文字列): GitHubコード検索構文を使用した検索クエリ
  • sort (オプションの文字列): ソートフィールド ('indexed' のみ)
  • order (オプションの文字列): ソート順 ('asc' または 'desc')
  • per_page （オプションの数値）：1ページあたりの結果数（最大100件）
  • page （オプションの数字）: ページ番号
• 戻り値: リポジトリコンテキストを含むコード検索結果

14. search_issues

• 問題とプルリクエストを検索する
• 入力:
  • q (文字列): GitHub の問題検索構文を使用した検索クエリ
  • sort (オプションの文字列): 並べ替えフィールド (コメント、反応、作成など)
  • order (オプションの文字列): ソート順 ('asc' または 'desc')
  • per_page （オプションの数値）：1ページあたりの結果数（最大100件）
  • page （オプションの数字）：ページ番号
• 戻り値: 問題とプルリクエストの検索結果

15. search_users

• GitHubユーザーを検索
• 入力:
  • q (文字列): GitHubユーザーの検索構文を使用した検索クエリ
  • sort (オプションの文字列): 並べ替えフィールド (フォロワー、リポジトリ、参加)
  • order (オプションの文字列): ソート順 ('asc' または 'desc')
  • per_page （オプションの数値）：1ページあたりの結果数（最大100件）
  • page （オプションの数字）: ページ番号
• 返されるもの: ユーザー検索結果

16. list_commits

• リポジトリ内のブランチのコミットを取得します
• 入力:
  • owner (文字列): リポジトリの所有者
  • repo (文字列): リポジトリ名
  • page （オプションの文字列）：ページ番号
  • per_page （オプションの文字列）：ページあたりのレコード数
  • sha (オプションの文字列): ブランチ名
• 戻り値: コミットのリスト

17. get_issue

• リポジトリ内の問題の内容を取得します
• 入力:
  • owner (文字列): リポジトリの所有者
  • repo (文字列): リポジトリ名
  • issue_number (数値): 取得する問題番号
• 戻り値: Github Issueオブジェクトと詳細

18. get_issue_comments

• 問題またはプルリクエストのコメントを取得します
• 入力:
  • owner (文字列): リポジトリの所有者
  • repo (文字列): リポジトリ名
  • issue_number (数値): コメントを取得する問題/PR番号
• 戻り値: コメントID、本文、作成者、タイムスタンプを含むGitHubコメントオブジェクトの配列

検索クエリ構文

コード検索

• language:javascript : プログラミング言語で検索
• repo:owner/name : 特定のリポジトリを検索
• path:app/src : 特定のパスで検索
• extension:js : ファイル拡張子で検索
• 例: q: "import express" language:typescript path:src/

問題検索

• is:issueまたはis:pr : タイプでフィルタリング
• is:openまたはis:closed : 状態でフィルタリング
• label:bug : ラベルで検索
• author:username :著者で検索
• 例: q: "memory leak" is:issue is:open label:bug

ユーザー検索

• type:userまたはtype:org : アカウントの種類でフィルタリング
• followers:>1000 : フォロワー数でフィルタリング
• location:London : 場所で検索
• 例: q: "fullstack developer" location:London followers:>100

詳細な検索構文については、 GitHub の検索ドキュメントを参照してください。

設定

個人アクセストークン

適切な権限を持つGitHub 個人アクセス トークンを作成します。

• 個人アクセストークンに移動します（GitHubの設定>開発者設定）
• このトークンでアクセスするリポジトリを選択します（パブリック、すべて、または選択）
• repoスコープ（「プライベートリポジトリのフルコントロール」）を持つトークンを作成します
  • あるいは、パブリックリポジトリのみで作業する場合は、 public_repoスコープのみを選択します。
• 生成されたトークンをコピーする

Claude Desktopでの使用

Claude Desktop でこれを使用するには、 claude_desktop_config.jsonに以下を追加します。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。