Overview
What is GitHub GraphQL MCP Server?
A Model Context Protocol (MCP) server that provides access to GitHub's GraphQL API. It exposes a single tool for executing arbitrary GraphQL queries and mutations against GitHub's API. It is designed for developers who want to integrate GitHub data into MCP‑compatible applications such as Claude for Desktop.
How to use GitHub GraphQL MCP Server?
Install Python 3.10+, clone the repository, set up a virtual environment, install dependencies with pip install -r requirements.txt, and run the server with GITHUB_TOKEN=your_token python github_graphql_mcp_server.py. For use with Claude for Desktop, add a configuration entry with absolute paths to the Python executable and the server script, plus the GITHUB_TOKEN environment variable.
Key features of GitHub GraphQL MCP Server
- Execute any GraphQL query against GitHub’s API
- Support for variables in GraphQL operations
- Comprehensive error handling and reporting
- Detailed documentation with example queries
- Authenticated access via a GitHub Personal Access Token
Use cases of GitHub GraphQL MCP Server
- Retrieve repository details (name, description, star count, owner)
- Search for repositories by language, stars, or other criteria
- Get user information and their top starred repositories
- Execute custom GraphQL mutations against GitHub
FAQ from GitHub GraphQL MCP Server
What are the prerequisites for running the server?
Python 3.10 or higher and a GitHub Personal Access Token (PAT) are required.
How do I install and run the server?
Clone the repository, create a virtual environment, install dependencies with pip install -r requirements.txt, set the GITHUB_TOKEN environment variable, and run python github_graphql_mcp_server.py.
How do I configure the server with Claude for Desktop?
Add a JSON entry to your Claude Desktop configuration that specifies the full path to the virtual environment’s Python interpreter, the full path to the server script, and the GITHUB_TOKEN environment variable.
What are the GitHub API rate limits?
Authenticated requests are limited to 5,000 per hour; unauthenticated requests to 60 per hour.
What common errors might I encounter?
Errors include spawn python ENOENT (use full path to Python), ModuleNotFoundError (activate venv and install dependencies), and Error: GitHub token not found (set the GITHUB_TOKEN environment variable).
