A Model Context Protocol (MCP) server that provides access to GitHub's GraphQL API. This server exposes a single tool that allows executing arbitrary GraphQL queries and mutations against GitHub's API. Features - Execute any GraphQL query against GitHub's API - Comprehensive error handling and reporting - Detailed documentation with example queries - Support for variables in GraphQL operations Prerequisites - Python 3.10 or higher - A GitHub Personal Access Token (PAT) Installation 1. Clone this repository 2. Set up a virtual environment (recommended): 3. Install dependencies: Usage Running the Server Configuring with Claude for Desktop Add the following to your Claude Desktop configuration file: Replace /absolute/path/to/ with the actual path to your server file and add your GitHub token. Example Queries Get Repository Information Variables: Search Repositories Variables: Get User Information Variables: GitHub API Rate Limits Be aware of GitHub's API rate limits: - Authenticated requests: 5,000 requests per hour - Unauthenticated requests: 60 requests per hour Troubleshooting If you encounter issues: 1. Check your GitHub token has the correct permissions 2. Verify your virtual environment is properly set up and activated 3. Ensure your token is correctly set in the environment variables 4. If using Claude Desktop, ensure the path to Python is correct (use absolute path to the virtual environment Python) 5. Look at the server logs for error messages 6. Ensure your GraphQL query is valid for GitHub's schema 7. Restart Claude for Desktop after making config changes Common Errors **spawn python ENOENT** - This error means the Python executable wasn't found - Solution: Use the full path to your Python executable in the virtual environment (e.g., /path/to/your/.venv/bin/python) **ModuleNotFoundError: No module named 'httpx' (or other packages)** - The Python environment doesn't have the required dependencies installed - Solution: Make sure you've activated the virtual environment and run pip install -r requirements.txt