github-stars
If you are the rightful owner of github-stars and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcpreview.com.
A Cloudflare-powered MCP Server that allows you to search and query your GitHub starred repositories using natural language.
GitHub Stars MCP Server
A Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.
English |
Overview
This project creates a searchable database of your GitHub starred repositories by:
- Fetching all your starred repositories using the GitHub API
- Extracting and processing the README files from each repository
- Uploading the processed data to Cloudflare R2 storage
- Using Cloudflare AutoRAG to create embeddings for efficient searching
- Exposing a MCP Server that allows querying these repositories via natural language
Features
- Automatically fetches and processes GitHub starred repositories
- Scheduled weekly updates via GitHub Actions
- Stores repository metadata and README content
- Provides semantic search capabilities through Cloudflare AutoRAG
- Exposes a MCP-compatible API for integration with AI agents
Setup
Prerequisites
- Node.js (v22 recommended)
- PNPM package manager
- GitHub Personal Access Token with
repo
scope - Cloudflare account
Configuration
-
Clone this repository
-
Set up Cloudflare R2:
- Create a R2 bucket
- Configure R2 access credentials
-
Configure GitHub Secrets for the CI/CD workflow:
GH_TOKEN
: GitHub token for fetching starred repositoriesR2_ACCOUNT_ID
: Cloudflare account IDR2_ACCESS_KEY_ID
: R2 access keyR2_SECRET_ACCESS_KEY
: R2 secret keyR2_BUCKET
: R2 bucket name
-
Configure Cloudflare AutoRAG:
- Create an AutoRAG instance in Cloudflare
- Set the
AUTO_RAG_NAME
environment variable in your Cloudflare Worker
Local Development
To develop locally:
# Install dependencies
pnpm install
# Fetch your GitHub stars locally
pnpm dev:stars
# Run MCP server locally
pnpm dev:mcp
Deployment
Deploy to Cloudflare Workers:
pnpm deploy
The GitHub Action will automatically:
- Run weekly to update your starred repositories
- Upload the processed files to R2
- Rebuild the AutoRAG index
Usage
Once deployed, you can interact with the MCP Server using any MCP-compatible client:
SSE: https://your-worker-url.workers.dev
API Reference
MCP Tool: search_github_stars
Searches through your starred GitHub repositories.
Parameters:
query
(string): Natural language query to search repositories
Response:
- JSON result containing matching repositories and relevant README content