hackerdogs/graphql-voyager-mcp repository overview

⁠

⁠GraphQL-Voyager MCP Server

MCP server wrapper for Graphql Voyager⁠ — GraphQL schema exploration (use voyager CLI if available).

⁠What is Graphql Voyager?

Graphql Voyager (graphql-voyager) is a security tool that provides: GraphQL schema exploration (use voyager CLI if available).

See APIs-guru/graphql-voyager⁠ for full documentation.

No API keys required — Graphql Voyager runs locally inside the Docker container.

Summary. MCP server wrapper for Graphql Voyager⁠ — GraphQL schema exploration (use voyager CLI if available).

Tools:

• run_graphql_voyager — Run graphql-voyager with the given arguments. Returns structured JSON output.

⁠Tools Reference

⁠run_graphql_voyager

Run graphql-voyager with the given arguments. Returns structured JSON output.

{
  "raw": "graphql-voyager output will appear here"
}

⁠Tools Reference

⁠Example Prompts

Here are example prompts you can use with Claude (or any MCP client) when this tool is connected:

• "Run graphql-voyager with --help to see all available options."
• "Use graphql-voyager to scan the target 192.168.1.1."
• "What options does graphql-voyager support? Show me its help output."
• "Run graphql-voyager against example.com with default settings."
• "Execute graphql-voyager with verbose output enabled."
• "Use the graphql-voyager tool to analyze the target and report findings."

⁠Deploy

⁠Docker Compose (recommended)

docker-compose up -d

⁠Docker Run (stdio mode)

docker run -i --rm hackerdogs/graphql-voyager-mcp:latest

⁠Docker Run (HTTP streamable mode)

docker run -d -p 8282:8282 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8282 \
  hackerdogs/graphql-voyager-mcp:latest

⁠MCP Client Configuration

⁠Stdio mode (default)

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "graphql-voyager-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT",
        "hackerdogs/graphql-voyager-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

⁠HTTP mode (streamable-http)

First, start the server using Docker Compose or docker run with HTTP mode (see Deploy⁠ above), then point your MCP client at the running server:

{
  "mcpServers": {
    "graphql-voyager-mcp": {
      "url": "http://localhost:8282/mcp"
    }
  }
}

⁠Environment Variables

⁠Installing in Hackerdogs

The fastest way to get started is through Hackerdogs⁠:

1. Log in to your Hackerdogs account.
2. Go to the Tools Catalog.
3. Search for the tool by name (e.g. "nuclei", "naabu", "julius").
4. Expand the tool card and click Install — you're ready to go.

1. Vendor API key required? Add your key in the config environment variable field before clicking Install. Your key will be encrypted at rest.
2. Enable / Disable the tool anytime from the Enabled Tools page.
3. Need to update a key or parameter? Go to My Tools → toggle Show Decrypted Values → edit → Save.

⁠Build

docker build -t hackerdogs/graphql-voyager-mcp:latest .

⁠Testing

⁠Automated tests

./test.sh

⁠Test directly with Docker

1. Start the server in HTTP mode:

docker run -d --rm --name graphql-voyager-mcp-test -p 8282:8282 \
  -e MCP_TRANSPORT=streamable-http \
  hackerdogs/graphql-voyager-mcp:latest

2. Initialize the MCP session:

SESSION_ID=$(curl -s -D - -X POST http://localhost:8282/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST http://localhost:8282/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. Call a tool:

curl -s -X POST http://localhost:8282/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"run_graphql_voyager","arguments":{"arguments":"--help"}}}'

4. Clean up:

docker stop graphql-voyager-mcp-test

⁠Running the tool directly (bypassing MCP)

You can run the graphql-voyager CLI in the same container by overriding the entrypoint to introspect and explore GraphQL schemas without starting the MCP server.

Show help:

docker run -i --rm --entrypoint graphql-voyager hackerdogs/graphql-voyager-mcp:latest --help