GitHub GraphQL MCP Server

GitHub GraphQL MCP Server

site icon
2025.04.10 0
PythonGitHub API 访问GraphQL 查询开发效率
GitHub GraphQL MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 GitHub GraphQL API 的访问。该服务器暴露了一个工具,允许执行任意的 GraphQL 查询和变更操作,以访问 GitHub 的数据。
View on GitHub

Overview

基本能力

产品定位

GitHub GraphQL MCP Server 旨在为开发者提供一个便捷的方式来通过 GraphQL 查询和操作 GitHub 的数据,提升开发效率和集成能力。

核心功能

  • 执行任意 GraphQL 查询和变更操作
  • 全面的错误处理和报告
  • 详细的文档和示例查询
  • 支持 GraphQL 操作中的变量

适用场景

  • 开发者需要查询 GitHub 仓库、用户或搜索信息
  • 自动化工具需要集成 GitHub 数据
  • 开发团队需要监控或分析 GitHub 项目状态

工具列表

  • 主要工具:执行 GraphQL 查询和变更操作的能力

常见问题解答

  • spawn python ENOENT:Python 可执行文件未找到,需使用虚拟环境中 Python 的完整路径
  • ModuleNotFoundError:Python 环境中缺少依赖,需激活虚拟环境并安装依赖
  • GitHub token not found:未设置 GITHUB_TOKEN 环境变量

使用教程

使用依赖

  • Python 3.10 或更高版本
  • GitHub 个人访问令牌 (PAT)

安装教程

  1. 克隆仓库
  2. 设置虚拟环境: bash python3 -m venv .venv source .venv/bin/activate
  3. 安装依赖: bash pip install -r requirements.txt

调试方式

  1. 运行服务器: bash GITHUB_TOKEN=your_token python github_graphql_mcp_server.py
  2. 检查日志和错误信息
  3. 确保 GraphQL 查询符合 GitHub 的 schema

许可证

该项目遵循 MIT 开源许可条款。