GitHub Stars 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 提供语义搜索功能
• 暴露一个与 AI 代理集成的 MCP 兼容 API

设置

前提条件

• Node.js (推荐 v22)
• PNPM 包管理器
• 具有 repo 作用域的 GitHub 个人访问令牌
• 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 环境变量

本地开发

要在本地开发：

# 安装依赖
pnpm install

# 在本地获取你的 GitHub Stars
pnpm dev:stars

# 在本地运行 MCP 服务器
pnpm dev:mcp

部署

部署到 Cloudflare Workers:

pnpm deploy

GitHub Action 将自动执行以下操作：

1. 每周运行以更新你的标星仓库
2. 将处理后的文件上传到 R2
3. 重建 AutoRAG 索引

使用

部署后，你可以使用任何 MCP 兼容的客户端与 MCP 服务器交互：

SSE: https://your-worker-url.workers.dev

API 参考

MCP 工具: search_github_stars

搜索你的 GitHub 标星仓库。

参数:

• query (string): 用于搜索仓库的自然语言查询

响应:

• 包含匹配的仓库和相关 README 内容的 JSON 结果