MCP Graphql Forge

🚀 mcp-graphql-forge

mcp-graphql-forgeは、軽量で設定ベースのMCPサーバーです。選別されたGraphQLクエリをモジュール化されたツールとして公開し、エージェントが意図的なAPIインタラクションを行えるようにします。

🚀 クイックスタート

mcp-graphql-forgeを使用することで、任意のGraphQLエンドポイントをMCPサーバーに変換できます。そのツールはYAMLファイルで定義され、GraphQLクエリとそのパラメータが指定されます。これにより、アプリケーションコードを変更することなく、モジュール化された、安全で拡張しやすいサーバーを作成できます。

✨ 主な機能

• 任意のGraphQLエンドポイントをMCPサーバーに変換することができます。
• YAMLファイルを使用してツールを定義し、サーバーを柔軟に設定できます。
• アプリケーションコードを変更することなく、サーバーを構築できます。

📦 インストール

サーバーは環境変数とYAMLファイルを使用して設定されます。

環境変数

• FORGE_CONFIG：YAML設定ファイル（forge.yamlとツール定義）を含むフォルダのパスを指定します。未設定の場合は、現在のディレクトリ（.）がデフォルトになります。
• FORGE_DEBUG：true（大文字小文字を区別しません）に設定すると、stderrに詳細なデバッグログが出力され、取得したトークンやGraphQL呼び出しの完全なHTTPリクエスト/レスポンスが表示されます。デフォルトはfalseです。

forge.yaml

設定フォルダには、特殊な設定ファイルforge.yamlを使用して、一般的な設定属性を指定します。

以下の属性をファイルに指定できます。

• name：MCPサーバーの名前
• version：MCPサーバーのバージョン
• url：GraphQLエンドポイントのURL
• token_command：AuthorizationヘッダーのBearerトークンを要求するためのコマンド（オプション）

以下は設定の例です。

name: "ExampleServer"
version: "0.1.0"
url: "https://api.github.com/graphql"
token_command: "gh auth token"

ツール設定

フォルダ内の他のすべてのYAMLファイルは、設定ファイルと見なされます。各YAMLファイルは、MCPサーバーのツールを定義します。

以下の属性をファイルに指定できます。

• name：MCPツールの名前
• description：MCPツールの説明
• query：実行するGraphQLクエリ
• inputs：入力を定義し、GraphQLクエリに変数として渡すMCPツールの入力リスト
  • name：入力の名前
  • type：パラメータのタイプ；stringまたはnumberにできます
  • description：MCPツールで使用するパラメータの説明
  • required：属性が必須かどうかを指定するブール値

以下は設定の例です。

name: "getUser"
description: "`login`を使用してユーザーの基本情報（名前、URL、場所を含む）を取得します。"
query: |
  query ($login: String!) {
    user(login: $login) {
      id
      name
      url
      location
    }
  }
inputs:
  - name: "login"
    type: "string"
    description: "アカウントを一意に識別する`login`。"
    required: true

🔧 技術詳細

制限事項

• 各mcp-graphql-forgeインスタンスは、単一のURLで単一のGraphQLサーバーとのみ使用できます。
• すべてのリクエストは、Bearerトークン形式の同じAuthorizationヘッダーを使用します。
• GraphQLクエリはすべてツールとして公開され、リソースとしてではありません。これは、現在すべてのMCPクライアントがリソースをサポートしていないためです。