GitHub Mapper MCP Server

GitHub Mapper MCP サーバー

GitHub Mapper は、GitHub リポジトリのマッピングと分析を行うツールを提供する Model Context Protocol（MCP）サーバーです。ユーザーは GitHub Personal Access Token を設定し、指定したリポジトリの構造や概要統計など、詳細な情報を取得できます。

機能

• 認証用の GitHub Personal Access Token を設定
• GitHub リポジトリの構造をマッピングして分析
• リポジトリの概要情報（スター数、フォーク数、言語など）を取得
• リポジトリの詳細なファイル構造を提供

前提条件

• Node.js（v18.0.0 以降を推奨）
• npm（Node.js に同梱）
• 適切な権限を持つ GitHub Personal Access Token

インストール

Smithery 経由でインストール

Smithery 経由で GitHub Mapper を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install github-mapper-mcp-server --client claude

手動インストール

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

   git clone https://github.com/your-username/github-mapper-mcp-server.git
   cd github-mapper-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

使用方法

1. サーバーを起動します：

   npm start
   

2. サーバーは stdio 上で実行され、MCP クライアントと通信できます。

利用可能なツール

1. set-github-token

認証用の GitHub Personal Access Token を設定します。

• こちらで Personal Access Token を作成してください。Tokens (classic) を選択します。スコープ：repo

IDE または Claude Desktop での例：

Please set-github-token to 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

2. map-github-repo

GitHub リポジトリの構造をマッピングし、概要情報を提供します。

例：

Please map-github-repo https://github.com/dazeb/MCP-Github-Mapper

Cline または Roo-Cline MCP クライアントへの手動インストール：

{
  "mcpServers": {
    "github-mapper": {
      "command": "node",
      "args": ["/home/user/Documents/Cline/MCP/github-mapper/build/index.js"]
    }
  }
}

出力例

Repository Analysis Summary:

Name: Hello-World
Description: My first repository on GitHub!
Stars: 1234
Forks: 567
Primary Language: JavaScript
Created: 2023-01-01
Last Updated: 2023-06-15

Repository Structure:

{
  "src": {
    "components": {
      "Header.js": null,
      "Footer.js": null
    },
    "pages": {
      "index.js": null,
      "about.js": null
    },
    "styles": {
      "global.css": null
    }
  },
  "public": {
    "images": {
      "logo.png": null
    },
    "favicon.ico": null
  },
  "package.json": null,
  "README.md": null
}

画像

評価の実行

evals パッケージは MCP クライアントを読み込み、その後 index.ts ファイルを実行するため、テストのたびに再ビルドする必要はありません。npx コマンドの前に環境変数を付けることで、環境変数を読み込めます。詳しいドキュメントはこちらをご覧ください。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

エラー処理

• GitHub トークンが設定されていない場合は、最初に set-github-token ツールを使用するよう促すエラーメッセージが表示されます。
• 無効な GitHub URL またはリポジトリパスの場合は、適切なエラーメッセージが表示されます。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。