Integrations
Uses .env files to securely store GitHub access tokens needed for API authentication.
Enables querying GitHub's GraphQL API to retrieve repository information, issues, pull requests, user profiles, and project dependencies with precise data control to reduce token consumption.
Provides schema exploration and query execution capabilities for GitHub's GraphQL API, allowing for precise data retrieval through query customization.
GitHub GraphQL API MCP
English | 中文 | 日本語 | Español | Français
A tool based on MCP (Model Control Protocol) for querying and using the GitHub GraphQL API. This project provides a server that allows you to explore the GitHub GraphQL schema and execute GraphQL queries through MCP client tools (such as Claude AI).
Why Use GitHub GraphQL API
GitHub GraphQL API offers significant advantages over traditional REST APIs:
- Precise Data Retrieval: GraphQL allows clients to specify exactly which fields they need, avoiding excess data
- Reduced Token Consumption: By requesting only necessary fields, API response size is significantly reduced, lowering AI model token consumption
- Single Request for Related Data: One query can retrieve multiple related resources, reducing the number of requests
- Self-Documenting: Through its built-in documentation system, you can directly query and understand the API schema without external documentation
- Strong Type System: Provides type checking, reducing errors
This project leverages these advantages to provide tools that help you effectively explore the GitHub GraphQL API schema and execute optimized queries, providing AI assistants with efficient GitHub data retrieval capabilities.
Application Scenarios
Basic Functions
This tool easily implements the following common operations:
- Repository Basic Information Query: Get repository name, description, star count, branch list, and other basic information
- Issue Data Retrieval: Query issue lists, details, or comment content for specific repositories
- User Profile Access: Retrieve users' personal profiles, contribution statistics, and other public information
- Pull Request Status View: Get PR basic status, comment content, and merge information
- Project Dependency Query: Retrieve project dependency package lists and version information
Exploratory Advanced Functions
With GraphQL's flexible query capabilities, you can also try to implement the following advanced analysis functions:
- Repository Contribution Trend Analysis: Analyze code update frequency and contributor participation by aggregating commit data, evaluating project activity
- Issue Management and Classification: Organize issue data according to custom conditions, discover problems that need priority handling, and improve project management efficiency
- Code Review Pattern Analysis: Analyze PR comments and review processes, identify common problem patterns, and optimize code review workflow
- Contributor Network Visualization: Build collaboration relationships between project contributors, discover key contributors and areas of expertise
- Dependency Health Assessment: Evaluate the update frequency and potential security issues of project dependencies, providing dependency management suggestions
Features
- Query GitHub GraphQL schema root types (Query/Mutation)
- Get detailed documentation for specific types
- Query documentation and parameters for specific fields
- Execute GitHub GraphQL API queries directly, precisely retrieving needed data, reducing token consumption
- Bilingual support (English/Chinese)
Prerequisites
- Python 3.10 or higher
- GitHub personal access token (for accessing the GitHub API)
- Poetry (recommended dependency management tool)
Installation
- Clone the repository:
- Install dependencies using Poetry:
If you don't use Poetry, you can use the traditional method:
- Configure environment variables:
Create a .env
file and add your GitHub personal access token:
You can create it by copying the .env.example
file:
Then edit the .env
file, replacing your_github_token_here
with your actual GitHub token.
Usage
Starting the Server
Make sure you have activated the Poetry virtual environment (poetry shell
), then:
Run
After the server starts, you can connect to it via an MCP client (such as Claude AI).
Configure in Claude Desktop
You can configure this MCP server in the Claude desktop app for one-click startup:
- Open the Claude desktop app
- Go to settings, find the MCP server configuration section
- Add the following configuration (modify according to your actual path):
Configuration example:
If you use conda or other environment management tools:
After configuration, you can start the MCP server directly from the Claude desktop app without having to start it manually.
Available Tools
The server provides the following tools:
- print_type_field: Query fields of GitHub GraphQL schema root types
- graphql_schema_root_type: Get documentation for root types (Query/Mutation)
- graphql_schema_type: Query documentation for specific types
- call_github_graphql: Execute GitHub GraphQL API queries
Usage Examples
After connecting to the server with an MCP client, you can:
- Query root type documentation:Copy
- Query fields of specific types:Copy
- Query documentation for specific types:Copy
- Execute GraphQL queries:Copy
Example Screenshot
Below is an example of using the GitHub GraphQL API MCP with Claude:
Notes
- Make sure your GitHub token has appropriate permissions before use
- The token is stored in the
.env
file, which should not be committed to version control systems - Queries should comply with GitHub API usage limits
License
This project is licensed under the MIT License - a very permissive license that allows users to freely use, modify, distribute, and commercialize this software, as long as they retain the copyright notice and license statement.
See MIT License for detailed terms.
This server cannot be installed
A server that allows you to explore the GitHub GraphQL schema and execute GraphQL queries through MCP client tools, enabling efficient data retrieval from GitHub with reduced token consumption.
Related MCP Servers
- AsecurityAlicenseAqualityMCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.Last updated -1722,91244,247JavaScriptMIT License
- AsecurityFlicenseAqualityProvides tools for mapping and analyzing GitHub repositories. It allows users to set a GitHub Personal Access Token and retrieve detailed information about a specified repository, including its structure and summary statistics.Last updated -216TypeScript
- AsecurityAlicenseAqualityAn MCP server for gitingest. It allows MCP clients like Claude Desktop, Cursor, Cline etc to quickly extract information about Github repositories including repository summaries, project directory structure, file contents, etcLast updated -38PythonMIT License
- AsecurityFlicenseAqualityAn MCP server that enables integration with GitHub Enterprise API, allowing users to access repository information, manage issues, pull requests, workflows, and other GitHub features through Cursor.Last updated -163313TypeScript