GitHub MCP Server 🚀

Node.js と TypeScript で構築されたカスタム Model Context Protocol (MCP) サーバーです。このサーバーにより、MCP 互換の AI アシスタント（Gemini Code Assist、Claude Desktop、Roo Code など）が GitHub アカウントと直接やり取りできるようになります。

✨ 機能（利用可能なツール）

このサーバーは、AI アシスタントに 7 つの強力なツールを提供します：

1. create_repository: 新しい公開または非公開のリポジトリを作成します。

2. get_my_repositories: 認証済みユーザーの最近更新されたリポジトリを一覧表示します。

3. get_repository: 特定のリポジトリの詳細を取得します。

4. get_file_content: コード分析のために、リポジトリ内の任意のファイルの正確な内容を読み取ります。

5. search_code: リポジトリ全体で関数、キーワード、構文を検索します。

6. create_issue: 特定のリポジトリに新しい issue を開きます。

7. list_issues: リポジトリのオープンな issue を表示します。

🛠️ インストールとセットアップ

1. リポジトリをクローンします：

   git clone [https://github.com/YOUR_USERNAME/mcp-github-server.git](https://github.com/YOUR_USERNAME/mcp-github-server.git)
   cd mcp-github-server
   Install dependencies:

Bash npm install プロジェクトをビルドします：

Bash npm run build

🔑 GitHub トークンの取得方法

このサーバーがあなたの代わりに動作するには、GitHub から Personal Access Token (PAT) が必要です。

GitHub アカウントの設定に移動します。

左サイドバーの下部にある「Developer settings」に移動します。

「Personal access tokens」→「Tokens (classic)」をクリックします。

「Generate new token (classic)」をクリックします。

トークンにメモを付けます（例：「MCP Server」）。

必要なスコープ：

「repo」ボックスにチェックを入れます（これにより、プライベートリポジトリの完全な制御が許可され、リポジトリの作成、ファイルの読み取り、issue の管理に必要です）。

下にスクロールして「Generate token」をクリックします。

トークンをすぐにコピーします（ghp_... で始まります）。

環境の設定 このプロジェクトのルートディレクトリに .env ファイルを作成します：

Bash touch .env トークンを .env ファイルに追加します：

مقتطف الرمز GITHUB_TOKEN=your_generated_token_here 🔌 IDE / AI クライアントへの接続 MCP 対応の IDE または拡張機能でこのサーバーを使用するには、クライアントの MCP 設定（通常は mcp.json または mcp_config.json ファイル）を、ビルドされた index.js ファイルを指すように構成する必要があります。

設定例：

JSON { "mcpServers": { "github-mcp": { "command": "node", "args": [ "--no-warnings", "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js" ], "env": { "GITHUB_TOKEN": "your_generated_token_here" } } } }

注：ABSOLUTE_PATH_TO_YOUR_PROJECT を、お使いのマシン上の実際のパスに置き換えてください。

🤝 コントリビューション これは小さな教育用プロジェクトです！ さらに多くのツール（プルリクエスト管理やコミット読み取りなど）を追加したい場合は、リポジトリをフォークしてプルリクエストを送信してください。