Graphql To MCP Server

@Docat0209

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

Docat0209

提交者

CHENG-SHIANG HO

关于 Graphql To MCP Server

暂无概览

Graphql To MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-graphql-docat0209": {
      "command": "npx",
      "args": [
        "graphql-to-mcp",
        "https://countries.trevorblades.com/graphql"
      ]
    }
  }
}

Graphql To MCP Server 工具

[GraphQL query: continent → Continent]

[GraphQL query: continents → [Continent!]!]

[GraphQL query: countries → [Country!]!]

[GraphQL query: country → Country]

[GraphQL query: language → Language]

[GraphQL query: languages → [Language!]!]

概览

What is Graphql To Mcp?

Graphql To Mcp turns any GraphQL API into MCP (Model Context Protocol) tools with zero configuration. By pointing it at a GraphQL endpoint, it automatically discovers all queries and mutations via introspection and generates one MCP tool per operation. It works with Claude Desktop, Cursor, Windsurf, and any MCP client.

How to use Graphql To Mcp?

Run it directly with npx graphql-to-mcp <graphql-endpoint-url> (no install needed) or add it to a Claude Desktop or Cursor config file under mcpServers. Optional flags include --bearer, --api-key, --include, --exclude, --prefix, --timeout, --max-retries, and --transport. It can also be used programmatically via the createServer function.

Key features of Graphql To Mcp

Zero configuration – just provide a GraphQL endpoint URL
Auto-introspection discovers all queries and mutations
Flat parameter schemas improve LLM accuracy
Smart truncation handles large responses (array slicing, depth limiting, character cap)
Auth support: Bearer tokens, API keys, and custom headers
Include/exclude filters to control which operations are exposed

Use cases of Graphql To Mcp

Give an LLM like Claude access to query and mutate a GraphQL API
Combine multiple GraphQL APIs in one MCP client using the --prefix option
Pair with mcp-openapi to expose both GraphQL and REST endpoints to the same LLM
Securely expose a subset of operations to an AI assistant using include/exclude filters

常见问题

How does Graphql To Mcp handle large responses?

GraphQL responses are automatically truncated: arrays are sliced to 20 items (with metadata showing total count), object depth is limited to 5 levels, and a hard cap of 50,000 characters is applied to prevent overwhelming LLM context windows.

Does Graphql To Mcp support authentication?

Yes. It supports Bearer tokens (via `--bearer`), API keys (via `--api-key` specifying name, value, and location), and arbitrary custom headers (via `--header` or the `-H` flag).

Can I expose only specific queries or mutations?

Yes. Use the `--include <pattern>` flag to include only operations matching a pattern, and `--exclude <pattern>` to hide matching operations. Patterns support wildcards (e.g., `get*`).

What transport protocols does Graphql To Mcp support?

It supports both `stdio` (default) and `sse` (Server-Sent Events) transport, selectable via the `--transport` option.

Is there any code or configuration required to get started?

No. Just run `npx graphql-to-mcp https://your-api.com/graphql` and the server is ready. The only dependencies are Node.js (required to run `npx`) and network access to the GraphQL endpoint.

其他分类下的更多 MCP 服务器

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

ICSS

chokcoco

不止于 CSS

20.7K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K