Fibery MCP GraphQL Server

Fibery MCP GraphQL Server

LLM が有効な graphql クエリやミューテーションを作成できるように、Fibery GraphQL API を調査するツールを提供する Model Context Protocol（MCP）サーバーです。

機能

• スペースとタイプの一覧表示：Fibery アカウントで利用可能なすべての GraphQL スペースとタイプを取得して一覧表示します
• スキーマ SDL の取得：Fibery スペースの完全な GraphQL スキーマ SDL を取得します
• Fibery GraphQL の検証：生成された Fibery の GraphQL クエリまたはミューテーションを既知のスキーマに照らして検証します

前提条件

• Node.js（v20 以降）
• API アクセス権のある Fibery アカウント

MCP クライアントでの使用

このサーバーは Model Context Protocol を実装しており、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