Github Mapper

🚀 GitHub リポジトリマッパー MCP サーバー

GitHub Mapper は、Model Context Protocol (MCP) サーバーであり、GitHub リポジトリのマッピングと分析を行うためのツールを提供します。ユーザーは GitHub の個人用アクセストークンを設定し、指定したリポジトリの詳細情報（構造や要約統計情報など）を取得することができます。

🚀 クイックスタート

GitHub Mapper を使うことで、GitHub リポジトリの構造や要約情報を簡単に取得できます。まずは必要な環境をセットアップし、サーバーを起動してみましょう。

✨ 主な機能

• GitHub 個人用アクセストークンを設定して認証を行う
• GitHub リポジトリの構造をマッピングし分析する
• リポジトリの要約情報（スター数、フォーク数、使用言語など）を取得する
• 詳細なリポジトリのファイル構造を提供する

📦 インストール

Smithery を使用した自動インストール

Smithery を通じて、Claude Desktop 上に GitHub Mapper を自動でインストールできます。

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. サーバーは標準入出力で動作し、MCP クライアントと通信できるようになります。

高度な使用法

1. set-github-token

GitHub 個人用アクセストークンを設定して認証を行います。

• こちらのリンク here から個人用アクセストークンを作成してください。クラシックトークンを選択し、スコープは repo を選びます。

例えば、IDE や Claude Desktop で以下のように入力します。

請 set-github-token を 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 に設定してください

2. map-github-repo

GitHub リポジトリの構造をマッピングし、要約情報を取得します。
例：

請 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"]
    }
  }
}

出力例

リポジトリ分析の要約：

名前：Hello-World
説明：GitHub での最初のリポジトリ。
Stars 数：123
Forks 数：45
言語：JavaScript
貢献者数：6

ファイル構造：
- .github/workflows/
  - ci.yml
- README.md
- package.json
- src/
  - index.js
  - App.js

📚 ドキュメント

前提条件

• Node.js（v18.0.0 以上を推奨）
• npm（Node.js と一緒に提供されます）
• 適切な権限を持った GitHub 個人用アクセストークン

エラー処理

• Node.js のバージョンが要件を満たしていない場合、互換性の問題が発生する可能性があります。
• 有効な GitHub トークンが設定されていない場合、リポジトリのマッピング機能は正常に動作しません。

コントリビューション

コミュニティからの貢献を歓迎します！CONTRIBUTING.md ファイルを参照して、貢献の方法を確認してください。

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。