Fibery MCP GraphQL Server

Fibery MCP GraphQL 服务

这是一个模型上下文协议（MCP）服务，提供用于检查 Fibery GraphQL API 的工具，帮助你的大模型编写有效的 GraphQL 查询和变更操作。

功能

• 列出空间和类型：获取并列出 Fibery 账户中所有可用的 GraphQL 空间和类型
• 获取架构 SDL：获取 Fibery 空间的完整 GraphQL 架构 SDL
• 验证 Fibery GraphQL：根据已知架构验证为 Fibery 生成的 GraphQL 查询或变更操作

先决条件

• Node.js（v20 或更高版本）
• 具有 API 访问权限的 Fibery 账户

与 MCP 客户端搭配使用

此服务实现了模型上下文协议，可与任何兼容 MCP 的客户端搭配使用。MCP 端点位于：

{
  "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"
      }
    }
  }
}

安装

1. 克隆仓库
2. 安装依赖项：

bun install

MCP 工具

list_spaces_and_types

列出 Fibery 账户中所有可用的 GraphQL 空间和类型。

参数：无

响应：

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

get_schema_sdl

获取 Fibery 空间的完整 GraphQL 架构 SDL。包括所有类型定义、查询、变更操作等。

参数：

• space_id：要获取架构的空间 ID（必填）

响应：

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

validate_fibery_graphql

根据已知架构验证为 Fibery 生成的 GraphQL 查询或变更操作。返回任何验证错误。

参数：

• space_id：要依据其进行验证的空间 ID（必填）
• query_to_validate：要验证的 GraphQL 查询或变更操作（必填）

响应：

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

许可证

MIT