Peterparker57 Github MCP Server

🚀 GitHub MCP サーバー

GitHub の統合機能を提供する Model Context Protocol (MCP) サーバーです。このサーバーは MCP ツールを通じて GitHub リポジトリとやり取りし、リポジトリ管理、ファイル操作、コミット処理などの機能をサポートします。

✨ 主な機能

• アカウント管理と認証
• リポジトリの作成と管理
• ファイル操作（読み取り、書き込み、プッシュ、プル）
• コミット操作
• ディレクトリ同期
• リポジトリの比較と差分分析

📦 インストール

npm install @modelcontextprotocol/server-github

📚 ドキュメント

設定

サーバーを MCP 設定ファイル (cline_mcp_settings.json) に追加します：

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/path/to/github-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN_1": "your-github-token",
        "GITHUB_OWNER_1": "your-github-username"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

利用可能なツール

アカウント管理

list_accounts

サーバーに設定されている利用可能な GitHub アカウントを一覧表示します。

select_account

後続の操作に使用する GitHub アカウントを選択します。

リポジトリ管理

create_repository

新しい GitHub リポジトリを作成します。

{
  owner?: string;        // リポジトリの所有者（選択済みアカウントの場合は省略可能）
  name: string;          // リポジトリ名
  description: string;   // リポジトリの説明
  private?: boolean;     // プライベートリポジトリかどうか
}

clone_repository

GitHub リポジトリをローカルディレクトリにクローンします。

{
  owner?: string;    // リポジトリの所有者
  repo: string;      // リポジトリ名
  branch?: string;   // ブランチ名（デフォルト：main）
  outputDir: string; // ローカルクローンのターゲットディレクトリ
}

rename_repository

既存の GitHub リポジトリの名前を変更します。

{
  owner?: string;    // リポジトリの所有者
  repo: string;      // 現在のリポジトリ名
  new_name: string;  // 新しいリポジトリ名
}

ファイル操作

push_file

ファイルを GitHub リポジトリにプッシュします。

{
  owner?: string;     // リポジトリの所有者
  repo: string;       // リポジトリ名
  path: string;       // リポジトリ内のターゲットパス
  message: string;    // コミットメッセージ
  sourcePath: string; // プッシュするローカルファイルのパス
}

pull_file

GitHub リポジトリからファイルをプルします。

{
  owner?: string;     // リポジトリの所有者
  repo: string;       // リポジトリ名
  path: string;       // リポジトリ内のファイルパス
  outputPath: string; // ローカルに保存するパス
}

sync_directory

ローカルとリモートのディレクトリを双方向に同期します。

{
  owner?: string;    // リポジトリの所有者
  repo: string;      // リポジトリ名
  path: string;      // リポジトリ内のターゲットパス
  outputDir: string; // ローカル同期のターゲットディレクトリ
}

コミット操作

create_commit

リポジトリに新しいコミットを作成します。

{
  owner?: string;       // リポジトリの所有者
  repo: string;         // リポジトリ名
  branch: string;       // ブランチ名
  message: string;      // コミットメッセージ
  author_name: string;  // コミット作者の名前
  author_email: string; // コミット作者のメールアドレス
}

開発

npm run dev

環境変数

• GITHUB_TOKEN_1: GitHub アカウント 1 のアクセストークン。
• GITHUB_OWNER_1: GitHub アカウント 1 の所有者名。
• 必要に応じて他の環境変数を拡張できます。

📄 ライセンス

[ここにライセンス情報を挿入]