MCP Graphql Schema

🚀 GraphQL 模式模型上下文协议服务器

このサーバーは、GraphQL スキーマ情報を Claude などの大規模言語モデル（LLMs）に公開する Model Context Protocol (MCP) サーバーです。LLM が GraphQL スキーマを探索し、理解することを可能にします。

✨ 主な機能

• コマンドライン引数で指定された任意の GraphQL スキーマファイルを読み込む
• クエリ、ミューテーション、サブスクリプションフィールドを探索する
• 詳細な型定義を表示する
• パターンマッチングを使用して型とフィールドを検索する
• 型とパラメータを含む簡略化されたフィールド情報を取得する
• 内部 GraphQL 型をフィルタリングして、よりクリーンな結果を得る

📦 インストール

コマンドライン

MCP サーバーを実行し、特定のスキーマファイルを指定します。

# 現在のディレクトリ内のデフォルトの schema.graphqls を使用する
npx -y mcp-graphql-schema

# 相対パスの特定のスキーマファイルを使用する
npx -y mcp-graphql-schema ../schema.shopify.2025-01.graphqls

# 絶対パスのスキーマファイルを使用する
npx -y mcp-graphql-schema /absolute/path/to/schema.graphqls

# ヘルプ情報を表示する
npx -y mcp-graphql-schema --help

Claude Desktop 統合

Claude Desktop でこの MCP サーバーを使用するには、claude_desktop_config.json 構成ファイルを編集します。

{
  "mcpServers": {
    "GraphQL Schema": {
      "command": "npx",
      "args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]
    }
  }
}

構成ファイルの場所：

• macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: $env:AppData\Claude\claude_desktop_config.json

Claude Code 統合

Claude Code CLI でこの MCP サーバーを使用するには、以下の手順に従います。

1. GraphQL スキーマ MCP サーバーを Claude Code に追加する

   # 基本構文
   claude mcp add graphql-schema npx -y mcp-graphql-schema
   
   # 特定のスキーマを持つ例
   claude mcp add shopify-graphql-schema npx -y mcp-graphql-schema  ~/Projects/work/schema.shopify.2025-01.graphqls
   

2. 登録された MCP サーバーを検証する

   # すべての構成されたサーバーをリストする
   claude mcp list
   
   # GraphQL スキーマサーバーの詳細情報を取得する
   claude mcp get graphql-schema
   

3. 必要に応じてサーバーを削除する

   claude mcp remove graphql-schema
   

4. Claude Code でツールを使用する 構成が完了したら、Claude Code セッションで GraphQL スキーマに関する質問をすることで、このツールを呼び出すことができます。

ヒント：

• -s または --scope フラグを使用して、project（デフォルト）または global で構成の保存場所を指定します。
• 異なるスキーマに複数の MCP サーバーを追加します（例：主要 API スキーマ、Shopify スキーマ）。

💻 使用例

基本的な使用法

# クエリ例：
# すべての利用可能なルートレベルのクエリフィールドをリストする
mcp query --tool list-query-fields

📚 ドキュメント

このサーバーは、LLM が GraphQL スキーマと対話するための以下のツールを提供します。

• list-query-fields: すべての利用可能なルートレベルのクエリフィールドをリストする
• get-query-field: 特定のクエリフィールドの詳細な SDL 定義を取得する
• list-mutation-fields: すべての利用可能なルートレベルのミューテーションフィールドをリストする
• get-mutation-field: 特定のミューテーションフィールドの詳細な SDL 定義を取得する
• list-subscription-fields: すべての利用可能なルートレベルのサブスクリプションフィールドをリストする（スキーマにサブスクリプションがある場合）
• get-subscription-field: 特定のサブスクリプションフィールドの詳細情報を取得する（スキーマにサブスクリプションがある場合）
• list-types: GraphQL スキーマで定義されたすべての型をリストする（内部型を除く）
• get-type: 特定の GraphQL 型の詳細な SDL 定義を取得する
• get-type-fields: 特定の GraphQL オブジェクト型の簡略化されたフィールドリストとその型を取得する
• search-schema: パターンマッチングを使用して型とフィールドを検索する

以上のツールと技術を使用することで、GraphQL スキーマ内で効果的に対話し、探索することができます。