MCP Github Mapper

🚀 GitHub マッパー MCP サーバー

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

🚀 クイックスタート

GitHub Mapper は、GitHub リポジトリの構造をマッピングし、要約情報を取得するための MCP サーバーです。以下に、基本的な使い方を説明します。

✨ 主な機能

• 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. サーバーは stdio 上で動作し、MCP クライアントと通信できます。

高度な使用法

1. set-github-token

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

• 個人用アクセストークンは ここ で作成できます。クラシックトークンを選択し、範囲は repo を選択してください。

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

請将 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 设置为-github-token

2. map-github-repo

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

請映射-github-repo https://github.com/dazeb/MCP-Github-Mapper

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

{
  "name": "your-app-name",
  "version": "1.0.0",
  "description": "Your app description here",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "github-mapper": "^1.2.3"
  }
}

出力例

GitHub Mapper の分析結果の例を示します。

要約情報

{
  "リポジトリ名": "your-repository-name",
  "スター数": 123,
  "ブランチ数": 45,
  "言語": "JavaScript",
  "主要な依存関係": ["express", "react"]
}

リポジトリ構造

.
├── README.md
├── package.json
├── index.js
└── src/
    ├── components/
    │   └── App.jsx
    └── services/
        └── api.js

📚 ドキュメント

画像

GitHub Mapper の例画像：画像リンク GitHub トークン設定の例画像：画像リンク

エラー処理

問題が発生した場合は、以下の一般的なエラーを確認してください。

⚠️ 重要提示

• トークンが設定されていない場合：set-github-token コマンドを実行したことを確認してください。
• 無効な URL の場合：リポジトリの URL が正しいことを確認してください。

貢献

GitHub Mapper への問題の報告やプルリクエストは大歓迎です！貢献ガイドは GitHub リポジトリ で確認してください。

📄 ライセンス

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