Fibery MCP GraphQL Server
2025.05.02
1
JavaScriptGraphQL 工具API 内省开发辅助开发效率
Fibery MCP GraphQL Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在帮助开发者通过 LLM 生成有效的 GraphQL 查询和变更。它提供了对 Fibery GraphQL API 的内省工具，包括列出空间和类型、获取模式 SDL 以及验证 GraphQL 查询的功能。
View on GitHub
Overview
基本能力
产品定位
Fibery MCP GraphQL Server 是一个专门为 Fibery 平台设计的 GraphQL 内省和验证工具，旨在提升开发效率，帮助开发者更高效地构建和验证 GraphQL 查询。
核心功能
- 列出空间和类型：获取 Fibery 账户中所有可用的 GraphQL 空间和类型列表。
- 获取模式 SDL：获取指定 Fibery 空间的完整 GraphQL 模式 SDL。
- 验证 GraphQL 查询：验证生成的 GraphQL 查询或变更是否符合 Fibery 的已知模式。
适用场景
- 开发者需要快速了解 Fibery 平台的 GraphQL API 结构时。
- 在开发过程中需要验证 GraphQL 查询的正确性时。
- 使用 LLM 生成 GraphQL 查询时，确保生成的查询有效。
工具列表
- list_spaces_and_types：列出所有可用的 GraphQL 空间和类型。
- get_schema_sdl：获取指定空间的完整 GraphQL 模式 SDL。
- validate_fibery_graphql：验证 GraphQL 查询或变更的有效性。
常见问题解答
- 如何获取 Fibery Token 和 URL：需要在 Fibery 账户中生成 API Token，并确保 URL 正确指向你的 Fibery 域名。
- 如何验证查询：使用
validate_fibery_graphql工具，提供空间 ID 和待验证的查询。
使用教程
使用依赖
- Node.js (v20 或更高版本)
- Fibery 账户并具有 API 访问权限
安装教程
- 克隆仓库
- 安装依赖：
bun install
调试方式
启动 MCP 服务器后，可以通过以下命令测试工具功能： 1. 列出空间和类型：
curl -X POST http://localhost:3000/list_spaces_and_types
- 获取模式 SDL：
curl -X POST -H "Content-Type: application/json" -d '{"space_id":"Space_Name"}' http://localhost:3000/get_schema_sdl
- 验证 GraphQL 查询：
curl -X POST -H "Content-Type: application/json" -d '{"space_id":"Space_Name", "query_to_validate":"query { ... }"}' http://localhost:3000/validate_fibery_graphql