AI导哈

GraphQL查询服务器

一个支持自然语言的GraphQL查询服务器，提供对配置端点的GraphQL查询功能。

  • by vivekb91
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 vivekb91/graphql-mcp

使用说明

GraphQL MCP服务器

一个模型上下文协议（MCP）服务器，提供GraphQL查询功能和自然语言支持。

特性

  • 对配置的端点执行GraphQL查询
  • 支持身份验证标头和自定义配置
  • 自然语言查询界面（需要AI模型集成）
  • 通过JSON文件轻松配置

设置

  1. 安装依赖项：
npm install
  1. 在中配置GraphQL端点 config.json:
{
  "graphql": {
    "endpoint": "https://your-api.com/graphql",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    }
  },
  "server": {
    "name": "GraphQL MCP Server",
    "version": "1.0.0"
  }
}

运行服务器

npm start

可用工具

graphql_query

直接对配置的端点执行GraphQL查询。

参数：

  • query （必填）：GraphQL查询字符串
  • variables （可选）：传递给查询的变量

natural_language_query

使用自然语言描述执行查询（需要AI模型集成）。

参数：

  • description （必填）：要获取的数据的自然语言描述
  • schema_hint （可选）：关于GraphQL模式结构的提示

示例用法

直接GraphQL查询

{
  "query": "query GetUsers { users { id name email } }"
}

自然语言查询

{
  "description": "Get all users with their names and emails",
  "schema_hint": "Users are in the 'users' field"
}

配置

编辑 config.json 自定义：

  • GraphQL端点URL
  • 身份验证标头
  • 服务器元数据

安全

  • 永远不要承诺你的 config.json 使用真正的API密钥
  • 在生产中为敏感数据使用环境变量
  • 确保GraphQL端点支持您计划进行的查询

相关 MCP