GitHub Stars MCP Server

GitHub Stars MCP Server

Cloudflare を活用した MCP（Model Context Protocol）サーバーです。自然言語で GitHub のスターを付けたリポジトリを検索、照会できます。

English | 简体中文

---

概要

このプロジェクトでは、次の手順で GitHub のスターを付けたリポジトリの検索可能なデータベースを作成します。

1. GitHub API を使用して、スターを付けたすべてのリポジトリを取得します
2. 各リポジトリの README ファイルを抽出して処理します
3. 処理済みデータを Cloudflare R2 ストレージにアップロードします
4. Cloudflare AutoRAG を使用して、効率的な検索のための埋め込みを作成します
5. 自然言語でこれらのリポジトリを照会できる MCP サーバーを公開します

機能

• GitHub のスターを付けたリポジトリを自動的に取得して処理します
• GitHub Actions を使用して、毎週定期的に更新します
• リポジトリのメタデータと README の内容を保存します
• Cloudflare AutoRAG を通じてセマンティック検索機能を提供します
• AI エージェントと連携するための MCP 互換 API を公開します

セットアップ

前提条件

• Node.js（v22 を推奨）
• PNPM パッケージマネージャー
• repo スコープを持つ GitHub Personal Access Token
• Cloudflare アカウント

設定

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

2. Cloudflare R2 をセットアップします。

   • R2 バケットを作成します
   • R2 のアクセス認証情報を設定します

3. CI/CD ワークフロー用の GitHub Secrets を設定します。

   • GH_TOKEN：スターを付けたリポジトリを取得するための GitHub トークン
   • R2_ACCOUNT_ID：Cloudflare アカウント ID
   • R2_ACCESS_KEY_ID：R2 アクセスキー
   • R2_SECRET_ACCESS_KEY：R2 シークレットキー
   • R2_BUCKET：R2 バケット名

4. Cloudflare AutoRAG を設定します。

   • Cloudflare に AutoRAG インスタンスを作成します
   • Cloudflare Worker に AUTO_RAG_NAME 環境変数を設定します
   • MCP_API_KEY：MCP サーバーへのアクセスを保護する API キー（安全なランダム文字列を生成してください）

ローカル開発

ローカルで開発するには、次の手順を実行します。

# Install dependencies
pnpm install

# Fetch your GitHub stars locally
pnpm dev:stars

# Run MCP server locally
pnpm dev:mcp

デプロイ

Cloudflare Workers にデプロイします。

pnpm deploy

GitHub Action は次の処理を自動的に実行します。

1. 毎週実行され、スターを付けたリポジトリを更新します
2. 処理済みファイルを R2 にアップロードします
3. AutoRAG インデックスを再構築します

使い方

デプロイ後は、MCP 互換クライアントを使用して MCP サーバーとやり取りできます。

API キー認証

セキュリティのため、MCP サーバーでは API キー認証が必要です。リクエストヘッダーに MCP_API_KEY を含めてください。

Authorization: Bearer your-mcp-api-key

エンドポイント

ストリーミング可能な HTTP：https://your-worker-url.workers.dev

API リファレンス

MCP ツール：search_github_stars

GitHub のスターを付けたリポジトリを検索します。

パラメーター：

• query（string）：リポジトリを検索するための自然言語クエリ

レスポンス：

• 一致したリポジトリと関連する README の内容を含む JSON 結果