GitHub_MCP

GitHub_MCP

1
developer_tools

The GitHub Star Count MCP Server is a Model Context Protocol server designed to fetch and provide star counts for public GitHub repositories, integrating seamlessly with Claude Desktop through a simple API.

GitHub Star Count MCP Server

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.