1. Conduid
  2. Developer Tools
  3. Mcp4gql
MCP server · Developer Tools

Mcp4gql

by · github.com/jorgeraad/mcp4gql

MCP server for interacting with a GraphQL server

Unclaimed MIT last commit a year ago devtools
InstallView source
49Fair

Scored 5 months ago · breakdown

About Mcp4gql

Mcp4gql is an MCP server published by jorgeraad in the Developer Tools category: mCP server for interacting with a GraphQL server.

The repository has 3 stars and 3 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/jorgeraad/mcp4gql

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Mcp4gql

Powered by Claude · Grounded in docs

I know everything about Mcp4gql. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

mcp4gql - GraphQL MCP Server

smithery badge

mcp4gql

This project is a Node.js/TypeScript server that implements the Model Context Protocol (MCP). It acts as a bridge, allowing MCP clients (like Cursor) to interact with a target GraphQL API.

Features

  • MCP Server: Implements the MCP Server class from @modelcontextprotocol/sdk.
  • Stdio Transport: Communicates with clients via standard input/output.
  • GraphQL Client: Uses axios to send requests to the configured GraphQL endpoint.
  • Generic GraphQL Tools: Exposes the following tools to MCP clients:
    • introspectGraphQLSchema: Fetches the target GraphQL API schema using introspection.
    • executeGraphQLOperation: Executes arbitrary GraphQL queries or mutations against the target API, taking query, optional variables, and optional operationName as input.

Configuration

The server requires the following environment variables:

  • GRAPHQL_ENDPOINT: The URL of the target GraphQL API.
  • AUTH_TOKEN: A bearer token for an optional Authorization: Bearer <token> header for authenticating with the GraphQL API.

Client Configuration

To allow clients like Cursor or Claude Desktop to use the tools provided by this server, you need to configure them to run the npx command.

Cursor

  1. Go to Cursor MCP Settings (Cursor > Settings > Cursor Settings > MCP)

  2. Go to + Add new global MCP server

  3. Add the following to your Cursor MCP configuration:

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

Claude Desktop

  1. Open Claude Desktop settings (Claude > Settings).

  2. Go to Developer > Edit Config.

  3. Add to the config:

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

Once configured, the MCP client should be able to list and call the introspectGraphQLSchema and executeGraphQLOperation tools provided by this server when relevant. Remember to set the required environment variables (GRAPHQL_ENDPOINT and optionally AUTH_TOKEN) in the configuration so the server can connect to your API.

README fetched from the repository 7 days ago. The original is authoritative.

Questions

About Mcp4gql

How do I install Mcp4gql?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Mcp4gql safe to use with an AI agent?

Its trust score is 49 out of 100 (fair). It passes 3 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Mcp4gql still maintained?

The last commit was a year ago and 2 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.