mcp-graphql-forge

一个轻量级、基于配置的MCP服务器，将经过筛选的GraphQL查询作为模块化工具公开，使您的代理能够进行有意图的API交互。

目的

mcp-graphql-forge允许您将任何GraphQL端点转换为一个MCP服务器，其工具由YAML文件定义，这些文件指定了GraphQL查询及其参数。这使您可以创建一个模块化、安全且易于扩展的服务器，而无需修改应用程序代码。

配置

服务器使用环境变量和YAML文件进行配置。

环境变量

• FORGE_CONFIG：指定包含YAML配置文件（forge.yaml和工具定义）的文件夹路径。默认为当前目录（.），如果未设置。
• FORGE_DEBUG：如果设置为true（不区分大小写），则启用详细的调试日志记录到stderr，包括获得的令牌以及GraphQL调用的完整HTTP请求/响应。默认为false。

forge.yaml

配置文件夹使用特殊的配置文件forge.yaml，其中指定了通用配置属性。

可以在文件中指定以下属性：

• name：MCP服务器的名称
• version：MCP服务器的版本
• url：GraphQL端点的URL
• token_command：用于请求Authorization头的Bearer令牌的命令（可选）

一个示例配置如下所示：

name: "ExampleServer"
version: "0.1.0"
url: "https://api.github.com/graphql"
token_command: "gh auth token"

工具配置

文件夹中的所有其他YAML文件都被视为配置文件。每个YAML文件定义一个MCP服务器的工具。

可以在文件中指定以下属性：

• name：MCP工具的名称
• description：MCP工具的描述
• query：要执行的GraphQL查询
• inputs：定义输入并传递给GraphQL查询作为变量的MCP工具的输入列表
  • name：输入的名称
  • type：参数类型；可以是string或number
  • description：MCP工具使用的参数描述
  • required：布尔值，指定属性是否为必需

一个示例配置如下所示：

name: "getUser"
description: "通过`login`获取用户的基本信息，包括他们的名称、URL和位置。"
query: |
  query ($login: String!) {
    user(login: $login) {
      id
      name
      url
      location
    }
  }
inputs:
  - name: "login"
    type: "string"
    description: "唯一标识其帐户的`login`。"
    required: true

局限性

• 每个mcp-graphql-forge实例只能与单个GraphQL服务器在单个URL上使用。
• 所有请求都使用相同的Authorization头，形式为Bearer令牌。
• GraphQL查询全部作为工具公开，而不是资源。这是因为当前并非所有MCP客户端都支持资源。