GraphQL API自省工具

Fibery MCP GraphQL Server是一个模型上下文协议(MCP)服务器,提供工具来内省Fibery GraphQL API,帮助您的LLM编写有效的GraphQL查询和变更。

  • by greatwitenorth
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 greatwitenorth/fibery-mcp-graphql

使用说明

Fibery MCP GraphQL服务器

这是一个模型上下文协议(MCP)服务器,它提供了内省Fibery GraphQL API的工具,以帮助您的LLM编写有效的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": []
}

许可证

麻省理工学院