GitHub Stars MCP Server

A Model Context Protocol (MCP) server for managing GitHub stars with vector storage, RAG-based Q&A, and Gitea backup.

Features

• list_stars - List GitHub starred repositories

• sync_stars - Sync and vectorize stars

• search_projects - Semantic vector search

• ask_about_projects - RAG-based Q&A

• fork_to_gitea - Backup projects to Gitea

• list_backed_up - List backed up projects

• get_project_info - Get project details

Installation

cd github-star-mcp
pip install -e .

Configuration

1. Create the config directory and copy the config template:

mkdir -p ~/.github-star-mcp
cp config.yaml.example ~/.github-star-mcp/config.yaml

2. Edit ~/.github-star-mcp/config.yaml with your settings:

github_token: your_github_token
github_username: your_username

gitea:
  url: http://localhost:3000
  token: your_gitea_token
  username: your_username

llm:
  provider: anthropic  # anthropic | openai | ollama
  api_key: your_api_key
  model: claude-sonnet-4-20250514
  base_url: ""  # Custom base URL for OpenAI compatible APIs

database:
  path: ~/.github-star-mcp/data.db

Usage

Command Line

github-star-mcp --github-token your_token --github-username your_user

Claude Desktop

Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "github-star-mcp": {
      "command": "github-star-mcp",
      "env": {
        "GITHUB_STAR_GITHUB_TOKEN": "your_token",
        "GITHUB_STAR_GITHUB_USERNAME": "your_user",
        "LLM_API_KEY": "your_key"
      }
    }
  }
}

Dependencies

• LanceDB - Embedded vector database (auto-created at ~/.github-star-mcp/vectors/)

• Gitea - Optional, for backup

• SQLite - Auto-created, for local storage

• Anthropic API - Optional, for RAG Q&A