mcp-graphql-forge

mcp-graphql-forge

0
developer_tools

mcp-graphql-forge is a versatile MCP server that turns GraphQL endpoints into modular tools, defined by YAML configuration. Designed for secure and extendable API interactions, it supports running in SSE mode and requires minimal setup for easy integration.

mcp-graphql-forge

A lightweight, configuration-driven MCP server that exposes curated GraphQL queries as modular tools, enabling intentional API interactions from your agents.

Purpose

mcp-graphql-forge lets you turn any GraphQL endpoint into an MCP server with tools defined via YAML files. This creates a modular, secure, and extendable server without modifying the app code.

Configuration

  • Configured using environment variables and YAML files.

Environment Variables

  • FORGE_CONFIG: Path to YAML configuration files, defaults to current directory.
  • FORGE_DEBUG: Enables detailed debug logging if true.

forge.yaml

  • Specifies common configuration attributes, including name, version, url, and optional token_command.

Tool Configuration

  • YAML files define each tool with attributes like name, description, query, and inputs.

Run in SSE Mode

  • Specify --sse to run in SSE mode with endpoints /mcp/sse and /mcp/message.

Limitations

  • Supports a single GraphQL server per instance.
  • Uses a single Bearer token for authorization.
  • Exposes GraphQL queries as Tools, not Resources.