Github MCP Server

🚀 GitHub MCP サーバー

このサーバーは、GitHubの統合機能を提供するモデルコンテキストプロトコル（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;       // リポジトリ内のファイルパス
  outputDir: string;  // プル先のローカルディレクトリ
}

delete_file

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

{
  owner?: string;     // リポジトリの所有者
  repo: string;       // リポジトリ名
  path: string;       // リポジトリ内のファイルパス
}

コミット操作

create_commit

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

{
  owner?: string;         // リポジトリの所有者
  repo: string;           // リポジトリ名
  branch: string;         // ブランチ名
  changes: {              // コミットする変更のリスト
    path: string;        // ファイルパス
    content: string;      // ファイル内容
    mode?: string;       // ファイルモード（オプション）
  }[]
}

開発

依存関係のインストール

開発用の依存関係をインストールするには、以下のコマンドを使用します。

npm install

ビルド

リリースバージョンを生成するためにプロジェクトをビルドします。

npm run build

環境変数

• GITHUB_TOKEN_<N>：認証に使用するGitHubの個人アクセストークン。
• GITHUB_OWNER_<N>：GitHubのユーザー名または組織名。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。