Overview
This MCP (Model Context Protocol) server provides access to the GitHub GraphQL API, enabling flexible queries against repository data and other GitHub resources. It exposes a single tool that can execute arbitrary GraphQL queries and mutations against the GitHub API, with built-in error handling and reporting to help diagnose failures. The server supports variables in GraphQL operations, allowing dynamic queries and reusable templates. It is designed to run in Python environments (Python 3.10+) and requires a GitHub Personal Access Token (PAT) for authenticated requests. Installation involves cloning the repository, creating and activating a virtual environment, and installing dependencies from requirements.txt. Usage centers on setting GITHUB_TOKEN and running github_graphql_mcp_server.py; Claude Desktop configuration is provided to integrate with the desktop app, including absolute paths. The README provides example queries such as GetRepo, SearchRepos, and GetUserInfo to illustrate typical usage. It also notes GitHub API rate limits for authenticated and unauthenticated requests, and offers troubleshooting steps ranging from token permissions to environment setup and server logs. The MIT license applies to this project.
Features
Execute GraphQL queries against GitHub API
Run arbitrary GraphQL queries against GitHub's GraphQL API through the MCP server.
Execute GraphQL mutations
Supports GraphQL mutations in addition to queries to modify data via the GitHub API.
Comprehensive error handling and reporting
Provides robust error handling and clear error reporting for GraphQL operations.
Support for variables in GraphQL operations
Allows passing variables to GraphQL operations for dynamic, reusable queries.
Single-tool MCP interface
Exposes a single tool to execute GraphQL requests against GitHub without multiple endpoints.
Detailed documentation and example queries
Includes extensive docs and example queries (e.g., GetRepo, SearchRepos, GetUserInfo) to demonstrate usage.
