mcp_agent

What is GitHub Stars MCP Server?

GitHub Stars MCP Server is a Model Context Protocol (MCP) server that analyzes GitHub users' starred repositories. It provides tools to list, analyze, search, and filter a user's starred projects, helping developers and AI assistants understand a user's interests and discover relevant open-source projects.

How to use GitHub Stars MCP Server?

Install with Python 3.10+ using uv pip install -e . or pip install -e .. Configure a GitHub Personal Access Token (optional but recommended) via the GITHUB_TOKEN environment variable. Run as an MCP server by adding it to a client's mcpServers configuration (e.g., in Claude Desktop) with command python -m github_stars_mcp or uv run python -m github_stars_mcp. Alternatively, run directly with python -m github_stars_mcp.

Key features of GitHub Stars MCP Server

• get_starred_repos – list starred repos with details
• analyze_starred_repos – full statistical analysis of starred repos
• search_starred_repos – search within repo names, descriptions, and topics
• filter_starred_repos – filter by language, topic, min stars, archived status
• Optional GitHub token raises API rate limit from 60 to 5000 requests/hour

Use cases of GitHub Stars MCP Server

• Discover a developer's technology interests through their starred projects
• Quickly find high-quality repos in a user's stars by filtering by language or stars
• Search for repos related to a specific topic (e.g., "machine learning") within a user's stars
• Analyze a user's star patterns to generate statistics like language distribution and top projects

FAQ from GitHub Stars MCP Server

What dependencies and runtime are required?

Python 3.10 or higher is required. Install dependencies using uv (recommended) or pip. A GitHub Personal Access Token is optional but recommended to avoid rate limiting.

How does GitHub Stars MCP Server handle authentication and rate limits?

The server uses the GitHub REST API v3. Without a token, requests are limited to 60 per hour. With a GitHub token set via the GITHUB_TOKEN environment variable, the limit increases to 5000 requests per hour.

What data does the server access and where does it live?

The server fetches starred repository data from the GitHub API (GET https://api.github.com/users/{username}/starred). No data is stored locally; all requests are made live to GitHub.

What are the known limitations of this server?

API rate limits apply (60/hour without token, 5000/hour with token). If a username does not exist or their starred repos are private, the server will return an error. Network connectivity to api.github.com is required.