MCP Graphql Forge

🚀 mcp-graphql-forge

mcp-graphql-forge 是一个轻量级、基于配置的 MCP 服务器，它将经过筛选的 GraphQL 查询作为模块化工具公开，助力您的代理进行有意图的 API 交互，为 API 交互提供了便捷、灵活的解决方案。

🚀 快速开始

mcp-graphql-forge 可将任意 GraphQL 端点转换为 MCP 服务器，其工具由 YAML 文件定义，这些文件明确了 GraphQL 查询及其参数。如此一来，您无需修改应用程序代码，就能创建出模块化、安全且易于扩展的服务器。

✨ 主要特性

• 轻量级设计，不增加过多系统负担。
• 基于配置，通过 YAML 文件灵活定义工具。
• 可将任意 GraphQL 端点转换为 MCP 服务器。
• 模块化设计，易于扩展。
• 保障服务器的安全性。

📦 安装指南

文档未提及安装步骤，暂不提供相关内容。

📚 详细文档

配置

服务器借助环境变量和 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 客户端都支持资源。