Skip to content
Back to search

mcp-graphql

Model Context Protocol server for GraphQL

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/blurrah--mcp-graphql/badge.svg)](/listings/blurrah--mcp-graphql)

HTML

<a href="/listings/blurrah--mcp-graphql"><img src="/api/listings/blurrah--mcp-graphql/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install GraphQL MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-graphql):

npx -y @smithery/cli install mcp-graphql --client claude

Installing Manually

It can be manually installed to Claude:

{
    "mcpServers": {
        "mcp-graphql": {
            "command": "npx",
            "args": ["mcp-graphql"],
            "env": {
                "ENDPOINT": "http://localhost:3000/graphql"
            }
        }
    }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 90 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mcp-graphql
  2. [![smithery badge](https://smithery.ai/badge/mcp-graphql)](https://smithery.ai/server/mcp-graphql)
  3. A Model Context Protocol server that enables LLMs to interact with GraphQL APIs. This implementation provides schema introspection and query execution capabilities, allowing models to discover and use GraphQL APIs dynamically.
  4. <a href="https://glama.ai/mcp/servers/4zwa4l8utf"><img width="380" height="200" src="https://glama.ai/mcp/servers/4zwa4l8utf/badge" alt="mcp-graphql MCP server" /></a>
  5. ## Usage
  6. Run `mcp-graphql` with the correct endpoint, it will automatically try to introspect your queries.
  7. ### Environment Variables (Breaking change in 1.0.0)
  8. > **Note:** As of version 1.0.0, command line arguments have been replaced with environment variables.
  9. | Environment Variable | Description | Default |
  10. |----------|-------------|---------|
  11. | `ENDPOINT` | GraphQL endpoint URL | `http://localhost:4000/graphql` |
  12. | `HEADERS` | JSON string containing headers for requests | `{}` |
  13. | `ALLOW_MUTATIONS` | Enable mutation operations (disabled by default) | `false` |
  14. | `NAME` | Name of the MCP server | `mcp-graphql` |
  15. | `SCHEMA` | Path to a local GraphQL schema file or URL (optional) | - |
  16. ### Examples
  17. ```bash
  18. # Basic usage with a local GraphQL server
  19. ENDPOINT=http://localhost:3000/graphql npx mcp-graphql
  20. # Using with custom headers
  21. ENDPOINT=https://api.example.com/graphql HEADERS='{"Authorization":"Bearer token123"}' npx mcp-graphql
  22. # Enable mutation operations
  23. ENDPOINT=http://localhost:3000/graphql ALLOW_MUTATIONS=true npx mcp-graphql
  24. # Using a local schema file instead of introspection
  25. ENDPOINT=http://localhost:3000/graphql SCHEMA=./schema.graphql npx mcp-graphql
  26. # Using a schema file hosted at a URL
  27. ENDPOINT=http://localhost:3000/graphql SCHEMA=https://example.com/schema.graphql npx mcp-graphql
  28. ```
  29. ## Resources
  30. - **graphql-schema**: The server exposes the GraphQL schema as a resource that clients can access. This is either the local schema file, a schema file hosted at a URL, or based on an introspection query.
  31. ## Available Tools
  32. The server provides two main tools:
  33. 1. **introspect-schema**: This tool retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource.
  34. This uses either the local schema file, a schema file hosted at a URL, or an introspection query.
  35. 2. **query-graphql**: Execute GraphQL queries against the endpoint. By default, mutations are disabled unless `ALLOW_MUTATIONS` is set to `true`.
  36. ## Installation
  37. ### Installing via Smithery
  38. To install GraphQL MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-graphql):
  39. ```bash
  40. npx -y @smithery/cli install mcp-graphql --client claude
  41. ```
  42. ### Installing Manually
  43. It can be manually installed to Claude:
  44. ```json
  45. {
  46. "mcpServers": {
  47. "mcp-graphql": {
  48. "command": "npx",
  49. "args": ["mcp-graphql"],
  50. "env": {
  51. "ENDPOINT": "http://localhost:3000/graphql"
  52. }
  53. }
  54. }
  55. }
  56. ```
  57. ## Security Considerations
  58. Mutations are disabled by default as a security measure to prevent an LLM from modifying your database or service data. Consider carefully before enabling mutations in production environments.
  59. ## Customize for your own server
  60. This is a very generic implementation where it allows for complete introspection and for your users to do whatever (including mutations). If you need a more specific implementation I'd suggest to just create your own MCP and lock down tool calling for clients to only input specific query fields and/or variables. You can use this as a reference.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.