Happy slice of mcp pizzaMCP.pizza

github-stars

MCP.Pizza Chef: miantiao-me

Everything you have ever starred on GitHub gets collected once a week, README and all, then indexed so your assistant can find the right one from a vague description like "that Rust tool for parsing logs". Exactly one search tool is offered. This is not something you simply install: you host it yourself on Cloudflare, which means a GitHub token, a Cloudflare account, a storage bucket and a search index, and the running costs land on your own bill.

Coding
Web/Research

Use This MCP server To

Find that starred repo I can only half remember List my starred projects that resize or convert images Rediscover a tool I bookmarked many months ago Compare a few starred libraries that solve the same problem Search my stars by what a project does, not its name

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

github-stars FAQ

What do I need to sign up for?
Quite a lot. A GitHub personal access token, a Cloudflare account, a Cloudflare storage bucket with its own access keys, and a Cloudflare search index. You also invent your own access key for the finished server.
Is it free to run?
The code is free and openly licensed, but it runs on your own Cloudflare account, so the storage and the searching are billed to you once you pass Cloudflare's free allowances.
The README says the server is protected by a key. Is it?
Only if you remember to set one. The check is skipped entirely when that setting is left empty, which leaves your copy open to anyone who learns its web address. Set the key before you deploy.
Is there a privacy catch?
Yes, one worth knowing. The weekly job commits every collected README back into your own copy of the project and uploads them to your bucket. The instructions ask for a broad GitHub token, so anything you starred privately can end up in that copy. Keep your copy private.
How hard is setup?
This one is for developers. There is no paste-a-snippet route; you clone the project, wire up several Cloudflare services and deploy it.
How current are the results?
A scheduled job refreshes your stars once a week, and you can trigger it by hand. Anything starred since the last run will not show up yet.
Can I use this to find a project I starred last year?
Yes, that is exactly what it is for. Describe what the project did and it searches the README text rather than only the name.
Which apps does it work in?
Any assistant that can connect to a hosted MCP address and send your access key along with the request.