GitHub Stars

v1.0.0Version Controlstable

A Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.

autoragcloudflarecloudflare-agentsgithub-starsmcp
Share:
107
Stars
0
Downloads
0
Weekly
0/5

What is GitHub Stars?

GitHub Stars is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to cloudflare-powered mcp (model context protocol) server that allows you to search and query your github starred repositories using natural language.

A Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.

This server falls under the Version Control category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Cloudflare-powered MCP (Model Context Protocol) Server tha

Use Cases

Search and query your GitHub starred repositories using natural language. Discover projects by description without manual browsing.
miantiao-me

Maintainer

LicenseApache-2.0
Languagejavascript
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx github-stars

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use GitHub Stars

The GitHub Stars MCP Server is a Cloudflare Workers-powered service that indexes your GitHub starred repositories and makes them searchable via natural language through an MCP interface. It uses Cloudflare AutoRAG to build a semantic search index over your stars, including README excerpts, so you can find projects by describing what they do rather than remembering their names. The server is ideal for developers who accumulate large numbers of starred repos and want an AI-powered way to rediscover them.

Prerequisites

  • A Cloudflare account with access to Workers, R2 storage, and AutoRAG
  • A GitHub personal access token (GH_TOKEN) with read:user and public_repo scopes
  • Node.js 18 or later and pnpm installed for local development
  • An MCP client that supports remote HTTP-based MCP servers
1

Clone the repository

Clone the github-stars repository and install dependencies with pnpm.

git clone https://github.com/miantiao-me/github-stars
cd github-stars
pnpm install
2

Create a Cloudflare R2 bucket

Log in to the Cloudflare dashboard and create an R2 bucket to store the starred repository data. Note the bucket name for use in the next steps.

3

Configure environment variables

Set the required secrets for the Cloudflare Worker. These can be set via the Cloudflare dashboard or using wrangler secrets.

# Set Cloudflare Worker secrets
npx wrangler secret put GH_TOKEN
npx wrangler secret put R2_ACCOUNT_ID
npx wrangler secret put R2_ACCESS_KEY_ID
npx wrangler secret put R2_SECRET_ACCESS_KEY
npx wrangler secret put R2_BUCKET
npx wrangler secret put AUTO_RAG_NAME
npx wrangler secret put MCP_API_KEY
4

Deploy the Cloudflare Worker

Deploy the MCP server to Cloudflare Workers. A GitHub Actions workflow is included to auto-sync starred repos weekly.

pnpm deploy
5

Configure your MCP client

Add the deployed Worker URL to your MCP client configuration, including the MCP_API_KEY as a Bearer token in the authorization header.

// claude_desktop_config.json (remote HTTP server)
{
  "mcpServers": {
    "github-stars": {
      "type": "http",
      "url": "https://your-worker.your-subdomain.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer your_mcp_api_key"
      }
    }
  }
}

GitHub Stars Examples

Client configuration

MCP client config connecting to the deployed Cloudflare Worker endpoint

{
  "mcpServers": {
    "github-stars": {
      "type": "http",
      "url": "https://your-worker.your-subdomain.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer your_mcp_api_key"
      }
    }
  }
}

Prompts to try

Natural language queries for searching your GitHub starred repositories

- "Find starred repos related to machine learning model serving."
- "Which of my starred projects are about SQLite performance?"
- "Search my stars for Rust async runtime libraries."
- "Show me starred repos about CSS animation frameworks."

Troubleshooting GitHub Stars

search_github_stars returns no results after deployment

The AutoRAG index may not have been built yet. Trigger the GitHub Actions sync workflow manually or wait for the weekly scheduled run to index your starred repositories.

Authentication errors when connecting to the MCP endpoint

Ensure MCP_API_KEY in your client config exactly matches the secret you set with 'wrangler secret put MCP_API_KEY'. The Authorization header must use the 'Bearer ' prefix.

GH_TOKEN rate limit exceeded during sync

The GitHub API allows 5000 requests per hour for authenticated tokens. If you have a very large number of stars, the sync job may hit rate limits. Consider using a fine-grained personal access token with only the required read permissions.

Frequently Asked Questions about GitHub Stars

What is GitHub Stars?

GitHub Stars is a Model Context Protocol (MCP) server that cloudflare-powered mcp (model context protocol) server that allows you to search and query your github starred repositories using natural language. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install GitHub Stars?

Follow the installation instructions on the GitHub Stars GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with GitHub Stars?

GitHub Stars works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is GitHub Stars free to use?

Yes, GitHub Stars is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Version Control MCP Servers

Explore all version control servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "github-stars": { "command": "npx", "args": ["-y", "github-stars"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use GitHub Stars?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides