Skip to content
Back to search

github-stars

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/miantiao-me/github-stars with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/miantiao-me/github-stars'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/miantiao-me--github-stars/badge.svg)](/listings/miantiao-me--github-stars)

HTML

<a href="/listings/miantiao-me--github-stars"><img src="/api/listings/miantiao-me--github-stars/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 114 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # GitHub Stars MCP Server
  2. A Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.
  3. English | [简体中文](/README.zh.md)
  4. ---
  5. ## Overview
  6. This project creates a searchable database of your GitHub starred repositories by:
  7. 1. Fetching all your starred repositories using the GitHub API
  8. 2. Extracting and processing the README files from each repository
  9. 3. Uploading the processed data to Cloudflare R2 storage
  10. 4. Using Cloudflare AutoRAG to create embeddings for efficient searching
  11. 5. Exposing a MCP Server that allows querying these repositories via natural language
  12. ## Features
  13. - Automatically fetches and processes GitHub starred repositories
  14. - Scheduled weekly updates via GitHub Actions
  15. - Stores repository metadata and README content
  16. - Provides semantic search capabilities through Cloudflare AutoRAG
  17. - Exposes a MCP-compatible API for integration with AI agents
  18. ## Setup
  19. ### Prerequisites
  20. - Node.js (v22 recommended)
  21. - PNPM package manager
  22. - GitHub Personal Access Token with `repo` scope
  23. - Cloudflare account
  24. ### Configuration
  25. 1. Clone this repository
  26. 2. Set up Cloudflare R2:
  27. - Create a R2 bucket
  28. - Configure R2 access credentials
  29. 3. Configure GitHub Secrets for the CI/CD workflow:
  30. - `GH_TOKEN`: GitHub token for fetching starred repositories
  31. - `R2_ACCOUNT_ID`: Cloudflare account ID
  32. - `R2_ACCESS_KEY_ID`: R2 access key
  33. - `R2_SECRET_ACCESS_KEY`: R2 secret key
  34. - `R2_BUCKET`: R2 bucket name
  35. 4. Configure Cloudflare AutoRAG:
  36. - Create an AutoRAG instance in Cloudflare
  37. - Set the `AUTO_RAG_NAME` environment variable in your Cloudflare Worker
  38. - `MCP_API_KEY`: API key for securing MCP server access (generate a secure random string)
  39. ### Local Development
  40. To develop locally:
  41. ```bash
  42. # Install dependencies
  43. pnpm install
  44. # Fetch your GitHub stars locally
  45. pnpm dev:stars
  46. # Run MCP server locally
  47. pnpm dev:mcp
  48. ```
  49. ### Deployment
  50. Deploy to Cloudflare Workers:
  51. ```bash
  52. pnpm deploy
  53. ```
  54. The GitHub Action will automatically:
  55. 1. Run weekly to update your starred repositories
  56. 2. Upload the processed files to R2
  57. 3. Rebuild the AutoRAG index
  58. ## Usage
  59. Once deployed, you can interact with the MCP Server using any MCP-compatible client:
  60. ### API Key Authentication
  61. The MCP server requires API key authentication for security. Include your `MCP_API_KEY` in the request headers:
  62. ```http
  63. Authorization: Bearer your-mcp-api-key
  64. ```
  65. ### Endpoint
  66. Streamable HTTP: `https://your-worker-url.workers.dev`
  67. ## API Reference
  68. ### MCP Tool: `search_github_stars`
  69. Searches through your starred GitHub repositories.
  70. Parameters:
  71. - `query` (string): Natural language query to search repositories
  72. Response:
  73. - JSON result containing matching repositories and relevant README content

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.