MCP.so
ログイン

mcp4gql - GraphQL MCP Server

@jorgeraad

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

jorgeraad

mcp4gql - GraphQL MCP Server について

MCP server for interacting with a GraphQL server

mcp4gql - GraphQL MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "-y",
        "mcp4gql"
      ],
      "env": {
        "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
        "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
      }
    }
  }
}

mcp4gql - GraphQL MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

上のボタンで一時的なサンドボックスでこのサーバーを実行し、ツール一覧を取得できます。

概要

What is mcp4gql?

mcp4gql is a Node.js/TypeScript server that implements the Model Context Protocol (MCP), acting as a bridge for MCP clients like Cursor to interact with a target GraphQL API. It is intended for developers who want to query and introspect GraphQL APIs through MCP-compatible tools.

How to use mcp4gql?

Configure the environment variables GRAPHQL_ENDPOINT (the target GraphQL API URL) and optionally AUTH_TOKEN (a bearer token). Then configure an MCP client such as Cursor or Claude Desktop to run the server via npx, passing those environment variables. The server communicates over stdio and exposes the tools introspectGraphQLSchema and executeGraphQLOperation to the client.

Key features of mcp4gql

  • Implements the MCP Server class from @modelcontextprotocol/sdk
  • Communicates with clients via standard input/output (stdio transport)
  • Uses axios to send requests to the configured GraphQL endpoint
  • Exposes introspectGraphQLSchema tool for fetching the API schema
  • Exposes executeGraphQLOperation tool for running queries or mutations

Use cases of mcp4gql

  • Exploring a GraphQL API’s schema from within an MCP-enabled editor
  • Running ad-hoc GraphQL queries or mutations without leaving the development environment
  • Automating GraphQL operations through MCP workflows in Cursor or Claude Desktop

よくある質問

1

What tools does mcp4gql expose to MCP clients?

It exposes `introspectGraphQLSchema` to fetch the target API’s schema via introspection, and `executeGraphQLOperation` to execute arbitrary GraphQL queries or mutations with optional variables and operation name.

2

How do I configure mcp4gql for Cursor?

In Cursor MCP Settings, add a new global MCP server with the command `npx -y mcp4gql` and the required environment variables `GRAPHQL_ENDPOINT` and optional `AUTH_TOKEN`.

3

How do I configure mcp4gql for Claude Desktop?

In Claude Desktop settings, open Developer > Edit Config and add an entry under `mcpServers` using `npx` with `-y mcp4gql` as arguments and the same environment variables.

4

What dependencies does mcp4gql require?

It is a Node.js/TypeScript project that depends on `@modelcontextprotocol/sdk`, `axios`, and the standard Node.js runtime. It is run via `npx`, so Node.js must be installed.

5

How does authentication work with the target GraphQL API?

Authentication is optional. If the `AUTH_TOKEN` environment variable is set, the server includes an `Authorization: Bearer <token>` header in all GraphQL requests.

コメント

「その他」の他のコンテンツ