GitHub Star Count MCP Server

by JavaTheHutt1

1 404 downloads Not rated yet
GitHub

About

A Model Context Protocol (MCP) server that allows Claude to fetch star counts from public GitHub repositories. It integrates the GitHub API into Claude Desktop, enabling simple repository statistics retrieval.

Explore

- Fetch star counts for any public GitHub repository
- Integrates with Claude Desktop via MCP
- Simple API for getting repository statistics

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name GitHub Star Count MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Python 3.11+
- uv for dependency management
- GitHub Personal Access Token

Run the MCP server directly:

python star_count.py

Or use the provided shell script:

./run_star_count.sh

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "github star count mcp server": {
            "GitHub_MCP": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "GitHub_MCP": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

A Model Context Protocol (MCP) server that allows Claude to fetch star counts from GitHub repositories.

Features

- Fetch star counts for any public GitHub repository
- Integrates with Claude Desktop via MCP
- Simple API for getting repository statistics

Setup

Prerequisites

- Python 3.11+
- uv for dependency management
- GitHub Personal Access Token

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/gh_mcp.git
cd gh_mcp

2. Install dependencies:

   uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

3. Create a .env file with your GitHub token:

   GITHUB_TOKEN=your_github_token_here

Usage

Running the MCP Server

Run the MCP server directly:

python star_count.py

Or use the provided shell script:

./run_star_count.sh

Claude Desktop Integration

Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):

"github-star-count-mcp": {
  "command": "/bin/bash",
  "args": [
    "/path/to/gh_mcp/run_star_count.sh"
  ]
}

Example Prompts for Claude

Once the MCP server is configured with Claude Desktop, you can use prompts like:

Use the github-star-count-mcp MCP server to get the star count for the repository "anthropics/claude-api" owned by "anthropics"

Project Structure

- star_count.py: Main MCP server implementation
- github_integration.py: GitHub API integration functions
- run_star_count.sh: Helper script for running the MCP server
- test_mcp.py: Simple test MCP server for verification

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.