Use This MCP server To

Search GitHub starred repos using natural language queries Integrate GitHub stars data into AI agents via MCP API Automate weekly updates of starred repo metadata and READMEs Perform semantic search on repository README content Build AI copilots that reference your GitHub starred projects

README

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 repositories
- R2_ACCOUNT_ID: Cloudflare account ID
- R2_ACCESS_KEY_ID: R2 access key
- R2_SECRET_ACCESS_KEY: R2 secret key
- R2_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

github-stars FAQ

How does github-stars fetch my starred repositories?

It uses the GitHub API to automatically retrieve all your starred repositories and their metadata.

How often does the github-stars server update its data?

It updates weekly via scheduled GitHub Actions to keep your starred repos data current.

What storage does github-stars use for repository data?

It stores processed repository metadata and README content in Cloudflare R2 storage.

How does github-stars enable natural language search?

It uses Cloudflare AutoRAG to create embeddings for semantic search over your starred repos.

Can I integrate github-stars with AI models like OpenAI, Claude, or Gemini?

Yes, github-stars exposes an MCP-compatible API that works with various LLM providers including OpenAI, Anthropic Claude, and Google Gemini.

What prerequisites are needed to set up github-stars?

You need Node.js and a GitHub account with starred repositories; Cloudflare account is also required for storage and AutoRAG.

Is the github-stars server customizable for different update schedules?

By default, it updates weekly via GitHub Actions, but you can modify the workflow for custom schedules.

Does github-stars process all repository files?

It primarily processes README files to extract meaningful content for search and querying.