MCP Github Trending

🚀 MCP-GitHub-Trending サーバー

このサーバーは MCP サーバーで、シンプルな API インターフェースを通じて GitHub のトレンドリポジトリと開発者のデータにアクセスできます。

✨ 主な機能

• GitHub のトレンドリポジトリと開発者のデータにアクセスする
• プログラミング言語でフィルタリングする
• 期間（日、週、月）でフィルタリングする
• 一般的な言語でフィルタリングする
• 整形された JSON レスポンスを返す

📚 ドキュメント

このサーバーは以下のツールを実装しています。

get_github_trending_repositories

GitHub のトレンドリポジトリを取得します。以下のパラメータをサポートしています。

• language (オプション): リポジトリをプログラミング言語でフィルタリングする（例: "python", "javascript"）
• since (オプション): 期間でフィルタリングする ("daily", "weekly", "monthly")。デフォルトは "daily"
• spoken_language (オプション): 一般的な言語でフィルタリングする

レスポンスの例:

[
  {
    "name": "リポジトリ名",
    "fullname": "所有者/リポジトリ名",
    "url": "https://github.com/owner/repository-name",
    "description": "リポジトリの説明",
    "language": "Python",
    "stars": 1000,
    "forks": 100,
    "current_period_stars": 50
  }
]

get_github_trending_developers

GitHub のトレンド開発者を取得します。以下のパラメータをサポートしています。

• language (オプション): プログラミング言語でフィルタリングする（例: "python", "javascript"）
• since (オプション): 期間でフィルタリングする ("daily", "weekly", "monthly")。デフォルトは "daily"

レスポンスの例:

[
  {
    "username": "開発者",
    "name": "開発者名",
    "url": "https://github.com/developer",
    "avatar": "https://avatars.githubusercontent.com/u/123456",
    "repo": {
      "name": "リポジトリ名",
      "description": "リポジトリの説明",
      "url": "https://github.com/developer/repository-name"
    }
  }
]

📦 インストール

前提条件

• Python 3.12

インストール手順

パッケージをインストールします。

pip install mcp-github-trending

Claude Desktop の設定

MacOS の場合:

~/Library/Application\ 支持/Claude/claude_desktop_config.json

Windows の場合:

%APPDATA%/Claude/claude_desktop_config.json

api:
  host: "0.0.0.0"
  port: 8090

💻 使用例

基本的な使用法

プロジェクト構造

mcp-github-trending/
├── config.yaml      # 設定ファイル
├── requirements.txt # 依存関係管理
├── src/             # ソースコードディレクトリ
│   ├── main.py     # メインプログラム
│   └── api/        # API インターフェースディレクトリ
└── README.md        # 説明ドキュメント

実行

# 依存関係をインストールする
pip install -r requirements.txt

# サーバーを起動する
python src/main.py

デバッグ

MCP Inspector を使用する

以下のコマンドでデバッグモードを起動できます。

uvicorn --reload src.app:app --host 0.0.0.0 --port 8090

http://localhost:8090/docs にアクセスして API ドキュメントを確認します。

📄 ライセンス

このプロジェクトは MIT License を採用しています。