GitHub Star Count MCP Server

GitHub スター数 MCP サーバー

Claude が GitHub リポジトリのスター数を取得できるようにする、Model Context Protocol（MCP）サーバーです。

機能

• 公開されている任意の GitHub リポジトリのスター数を取得します
• MCP を介して Claude Desktop と連携します
• リポジトリの統計情報を取得するシンプルな API を提供します

セットアップ

前提条件

• Python 3.11+
• 依存関係の管理に使用する uv
• GitHub Personal Access Token

インストール

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

   git clone https://github.com/yourusername/gh_mcp.git
   cd gh_mcp
   

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

   uv venv
   source .venv/bin/activate
   uv pip install -r requirements.txt
   

3. GitHub トークンを記載した .env ファイルを作成します：

   GITHUB_TOKEN=your_github_token_here
   

使い方

MCP サーバーの実行

MCP サーバーを直接実行します：

python star_count.py

または、付属のシェルスクリプトを使用します：

./run_star_count.sh

Claude Desktop との連携

以下を Claude Desktop の設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

"github-star-count-mcp": {
  "command": "/bin/bash",
  "args": [
    "/path/to/gh_mcp/run_star_count.sh"
  ]
}

Claude 向けのプロンプト例

MCP サーバーを Claude Desktop に設定すると、次のようなプロンプトを使用できます：

Use the github-star-count-mcp MCP server to get the star count for the repository "anthropics/claude-api" owned by "anthropics"

プロジェクト構成

• star_count.py：MCP サーバーのメイン実装
• github_integration.py：GitHub API との連携関数
• run_star_count.sh：MCP サーバーの実行に使用するヘルパースクリプト
• test_mcp.py：動作確認用のシンプルな MCP テストサーバー

ライセンス

MIT

コントリビューション

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