Fibery MCP GraphQL Server

by greatwitenorth

318 downloads
Not rated
GitHub

About

MCP server to help your llm construct valid graphql queries for fibery.

Details

Author
greatwitenorth
Downloads
318
Categories
Other

- List all available GraphQL spaces and types in your Fibery account
- Get the complete GraphQL schema SDL for a Fibery space
- Validate a generated GraphQL query or mutation against the known schema

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Fibery MCP GraphQL Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js v20 or higher, clone the repository, and install dependencies with bun install. Configure an MCP‑compatible client with the command node and arguments pointing to the full path of index.js, and set the environment variables FIBERY_TOKEN and FIBERY_URL. Then invoke the provided tools: list_spaces_and_types, get_schema_sdl, and validate_fibery_graphql.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "fibery mcp graphql server": {
            "fibery-mcp-graphql": {
                "command": "node",
                "args": [
                    "/full-path-to/index.js"
                ],
                "env": {
                    "FIBERY_TOKEN": "your_fibery_token",
                    "FIBERY_URL": "your_fibery_domain.fibery.io"
                }
            }
        }
    }
}

McpServers

{
    "fibery-mcp-graphql": {
        "command": "node",
        "args": [
            "/full-path-to/index.js"
        ],
        "env": {
            "FIBERY_TOKEN": "your_fibery_token",
            "FIBERY_URL": "your_fibery_domain.fibery.io"
        }
    }
}

Fibery MCP GraphQL Server

This is a Model Context Protocol (MCP) server that provides tools to introspect the Fibery GraphQL API to help your LLM to write valid graphql queries and mutations.

Features

- List Spaces and Types: Fetches and lists all available GraphQL spaces and types in your Fibery account
- Get Schema SDL: Gets the complete GraphQL schema SDL for a Fibery space
- Validate Fibery GraphQL: Validates a generated GraphQL query or mutation for Fibery against the known schema

Prerequisites

- Node.js (v20 or higher)
- Fibery account with API access

Using with MCP Clients

This server implements the Model Context Protocol and can be used with any MCP-compatible client. The MCP endpoint is available at:

{
  "mcpServers": {
    "fibery-mcp-graphql": {
      "command": "node", // note: if using nvm, use the full path to the version of node you want to use
      "args": ["/full-path-to/index.js"],
      "env": {
        "FIBERY_TOKEN": "your_fibery_token",
        "FIBERY_URL": "your_fibery_domain.fibery.io"
      }
    }
  }
}

Installation

1. Clone the repository
2. Install dependencies:

bun install

MCP Tools

list_spaces_and_types

Lists all available GraphQL spaces and types in your Fibery account.

Parameters: None

Response:

{
"spaces": [
{
"name": "Space Name",
"url": "https://your-domain.fibery.io/api/graphql/space/Space_Name",
"id": "Space_Name"
},
...
],
"count": 5
}

get_schema_sdl

Gets the complete GraphQL schema SDL for a Fibery space. This includes all type definitions, queries, mutations, etc.

Parameters:
- space_id: The ID of the space to get the schema for (required)

Response:

{
"space_id": "Space_Name",
"sdl": "type Query { ... } type Mutation { ... } ..."
}

validate_fibery_graphql

Validates a generated GraphQL query or mutation for Fibery against the known schema. Returns any validation errors.

Parameters:
- space_id: The ID of the space to validate against (required)
- query_to_validate: The GraphQL query or mutation to validate (required)

Response:

{
"valid": true,
"errors": []
}

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.