Github Stars

🚀 GitHub 星標項目 MCP 服務器

這是一個由 Cloudflare 提供支持的 MCP（模型上下文協議）服務器，藉助它，你能夠通過自然語言對自己的 GitHub 星標倉庫進行搜索和查詢。

English | 簡體中文

🚀 快速開始

本項目可創建一個用於存儲 GitHub 星標倉庫的可搜索數據庫，具體步驟如下：

1. 藉助 GitHub API 獲取所有星標倉庫。
2. 提取並處理每個倉庫的 README 文件。
3. 將處理後的數據上傳至 Cloudflare R2 存儲。
4. 利用 Cloudflare AutoRAG 創建嵌入，實現高效搜索。
5. 暴露一個 MCP 服務器，支持通過自然語言查詢這些倉庫。

✨ 主要特性

• 自動獲取並處理 GitHub 星標倉庫。
• 藉助 GitHub Actions 實現每週更新。
• 存儲倉庫元數據和 README 內容。
• 提供語義搜索功能（通過 Cloudflare AutoRAG）。
• 暴露兼容 MCP 的 API，便於與 AI 代理集成。

📦 安裝指南

先決條件

• Node.js（推薦版本 v22）
• PNPM 包管理器
• 具備 repo 權限的 GitHub 個人訪問令牌
• Cloudflare 賬戶

配置步驟

1. 克隆此倉庫。
2. 設置 Cloudflare R2：
   • 創建一個 R2 存儲桶。
   • 配置 R2 訪問憑證。
3. 配置 GitHub 秘密用於 CI/CD 工作流：
   • 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。

本地開發

要進行本地開發，可按以下步驟操作：

# 安裝依賴
pnpm install

# 本地獲取您的 GitHub 星標倉庫
pnpm dev:stars

# 啟動 MCP 服務器（本地）
pnpm dev:mcp

部署

部署到 Cloudflare Workers：

pnpm deploy

GitHub Actions 將自動執行以下操作：

1. 每週運行一次以更新星標倉庫。
2. 將處理後的文件上傳到 R2。
3. 重建 AutoRAG 索引。

💻 使用示例

部署完成後，您可以使用任何 MCP 兼容客戶端與 MCP 服務器交互： SSE：https://your-worker-url.workers.dev

📚 詳細文檔

MCP 工具：search_github_stars

通過自然語言搜索您的 GitHub 星標倉庫。

參數

• query（字符串）：用於搜索的自然語言查詢。

響應

• 包含匹配倉庫和相關 README 內容的 JSON 結果。