🚀 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 结果。