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

设置

预备条件

• Node.js（推荐 v22）
• PNPM 包管理器
• 具有 repo 范围的 GitHub 个人访问令牌
• Cloudflare 账户

配置

1. 克隆此仓库

2. 设置 Cloudflare R2：

   • 创建一个 R2 存储桶
   • 配置 R2 访问凭证

3. 为 CI/CD 工作流配置 GitHub 密钥：

   • 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 密钥（生成一个安全的随机字符串）

本地开发

要进行本地开发：

# 安装依赖
pnpm install

# 本地获取您的 GitHub 收藏
pnpm dev:stars

# 运行本地 MCP 服务器
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（字符串）：用于搜索仓库的自然语言查询

响应：

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