mcp-graphql-forge 由 UnitVectorY-Labs 开发，是一个轻量级、配置驱动的 MCP 服务器。它的核心用途是把任意 GraphQL 端点转换为 MCP 服务器，并将其中的 GraphQL 查询以“工具”的形式暴露给 AI 智能体，从而实现有意图的 API 交互。
主要能力：
- 通过 YAML 文件定义 MCP 工具，每个 YAML 文件对应一个工具，其中指定 GraphQL 查询、参数及其类型、描述和是否必填等信息，无需修改应用代码即可扩展。
- 支持为工具添加 MCP 注解（annotations），用于提示工具行为，如 title、readOnlyHint、destructiveHint、idempotentHint、openWorldHint。
- 支持配置 GraphQL 响应输出格式：raw（原样透传，默认）、json（去除多余空格的精简 JSON）、toon（转换为 TOON 格式，Token-Oriented Object Notation，用于优化 LLM 的 token 使用）。
- 支持通过 token_command 获取 Bearer token 用于 Authorization 头，并可配置环境变量（env、env_passthrough）。
- 默认以 stdio 模式运行，也可通过 --http 参数以 Streamable HTTP 模式运行，端点形如 http://localhost:8080/mcp。
使用方式：
- 安装：官方版本发布在 GitHub Releases，提供 macOS、Linux、Windows 预编译可执行文件；若已安装 Go，也可从源码安装。
- 配置：通过命令行参数、环境变量和 YAML 文件配置。命令行参数 --forgeConfig 指定包含 forge.yaml 和工具定义 YAML 的文件夹路径，优先于环境变量 FORGE_CONFIG；--forgeDebug 启用详细调试日志到 stderr，优先于环境变量 FORGE_DEBUG。
- 通用配置文件 forge.yaml 可指定：name（MCP 服务器名称）、url（GraphQL 端点 URL）、token_command（获取 Bearer token 的命令，可选）、env（传给 token 命令的环境变量映射，可选）、env_passthrough（是否透传所有环境变量，可选，默认 false）。
- 工具配置 YAML 可指定：name、description、query、inputs（含 name、type（string 或 number）、description、required）、annotations、output。
适用场景：
- 需要将现有 GraphQL API 安全、最小化地暴露给 AI 智能体的场景。
- 希望通过配置而非编码来管理智能体可用 API 工具的场景。
限制：
- 每个 mcp-graphql-forge 实例只能用于单个 URL 的单个 GraphQL 服务器。
- 所有 GraphQL 查询都作为 Tools 暴露，而不是 Resources，即使它们不是 mutation。
- 若未配置 token_command，传入 MCP 服务器的 Authorization 头会透传到后端 GraphQL 端点。
- 关于具体收费、价格、平台支持范围、效果等更多信息暂未提供。
