mcpField
G
GitHub Stars MCP Server

GitHub Stars MCP Server

Local
github.com/ccbikaiVersion Control118Updated 4d ago
Repository

About GitHub Stars MCP Server

GitHub Stars MCP Server is a Cloudflare-based MCP server that lets users search their starred GitHub repositories in natural language. It fetches starred repositories and their READMEs, stores them in Cloudflare R2, and indexes them with AutoRAG. It suits developers who want to query their own saved repositories.

Key features

  1. 01Fetches starred repositories and README content
  2. 02Semantic search through Cloudflare AutoRAG
  3. 03Weekly automatic updates via GitHub Actions
  4. 04Bearer token authentication for MCP access
  5. 05Streamable HTTP endpoint

Use cases

  1. 01Finding previously starred projects with natural language
  2. 02Letting an AI assistant retrieve relevant starred repositories
  3. 03Deploying personal starred-repository search as a remote MCP server

MCP support

The server exposes a search_github_stars tool to MCP clients for natural language search over starred repositories.

#mcp#github-stars#cloudflare#autorag#cloudflare-agents

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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:

  1. Fetching all your starred repositories using the GitHub API
  2. Extracting and processing the README files from each repository
  3. Uploading the processed data to Cloudflare R2 storage
  4. Using Cloudflare AutoRAG to create embeddings for efficient searching
  5. 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

  1. Clone this repository

  2. Set up Cloudflare R2:

    • Create a R2 bucket
    • Configure R2 access credentials

  3. 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

  4. Configure Cloudflare AutoRAG:

    • Create an AutoRAG instance in Cloudflare
    • Set the AUTO_RAG_NAME environment variable in your Cloudflare Worker
    • MCP_API_KEY: API key for securing MCP server access (generate a secure random string)
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:

  1. Run weekly to update your starred repositories
  2. Upload the processed files to R2
  3. Rebuild the AutoRAG index

Usage

Once deployed, you can interact with the MCP Server using any MCP-compatible client:

API Key Authentication

The MCP server requires API key authentication for security. Include your MCP_API_KEY in the request headers:

Authorization: Bearer your-mcp-api-key
Endpoint

Streamable HTTP: 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.