[{"_1":2,"_295":-5,"_296":-5},"loaderData",{"_3":4,"_29":30,"_31":32,"_243":244},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","0198bf34-c7a5-737d-8c29-6372a26818c4","title","This MCP server does not support inspection","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":-5},"attributes",[22],"bot","id",11143072,"membership","referenceId","01989bb3-6f03-717c-8403-57f67b03b520","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_33":34,"_75":-5,"_76":35,"_36":77,"_159":160,"_241":242},"availableLocales",[35,47,54,61,68],{"_36":37,"_40":44,"_45":46},"mcpServer",{"_38":39,"_40":41,"_42":43},"description","A Model Context Protocol server that enables AI agents to dynamically interact with Hasura GraphQL endpoints through natural language, supporting schema discovery, data querying/manipulation, and aggregations.","name","Advanced Hasura GraphQL MCP Server","readme","\n# Advanced Hasura GraphQL MCP Server\n\n**Version:** 1.1.0\n\nThis Model Context Protocol (MCP) server provides an advanced interface for AI agents (like those in Cursor or Claude Desktop) to interact with a Hasura GraphQL endpoint. It enables agents to discover the API structure, execute both read-only queries and mutations (with caution), preview data, perform aggregations, and check service health.\n\nThis server enhances LLM capabilities by allowing them to leverage your Hasura API dynamically based on natural language requests.\n\n## Features\n\nThis server exposes the following MCP capabilities:\n\n**Resources:**\n\n* **Hasura GraphQL Schema (`hasura:/schema`)**\n * Provides the full GraphQL schema definition obtained via standard introspection.\n * **MIME Type:** `application/json`\n * Agents can read this resource to understand the complete structure of the API, including types, fields, arguments, directives, etc.\n\n**Tools:**\n\n* **`run_graphql_query`**\n * **Description:** Executes a read-only GraphQL query against the Hasura endpoint. Use this for fetching data when a specific tool isn't available. Ensure the query does not modify data. *Example: `query { users { id name } }`*\n * **Input:** `{ query: string, variables?: object }`\n * **Note:** Performs a basic check to prevent execution of strings starting with `mutation`. Primarily relies on the query itself being read-only.\n\n* **`run_graphql_mutation`**\n * **Description:** Executes a GraphQL mutation to insert, update, or delete data. **Use with caution**, ensure the operation is intended and safe. Relies on Hasura permissions configured for the provided Admin Secret or default role. *Example: `mutation { insert_users_one(object: {name: \"Test\"}) { id } }`*\n * **Input:** `{ mutation: string, variables?: object }`\n * **Security:** Allows any mutation permitted by the Hasura role. Ensure appropriate Hasura permissions are configured.\n\n* **`list_tables`**\n * **Description:** Lists available data tables (or collections) managed by Hasura, organized by schema with descriptions, based on introspection heuristics (looks for object types with an 'id' field, excluding internal/aggregate types). Useful for discovering available data sources.\n * **Input:** `{ schemaName?: string }` (Optional schema name, attempts to infer from field descriptions if possible, defaults to 'public' conceptually)\n\n* **`describe_table`**\n * **Description:** Shows the structure of a specific table including all its columns (fields) with their GraphQL types and descriptions.\n * **Input:** `{ tableName: string, schemaName?: string }`\n\n* **`list_root_fields`**\n * **Description:** Lists the available top-level query, mutation, or subscription fields from the GraphQL schema. Useful for understanding the primary entry points for operations.\n * **Input:** `{ fieldType?: 'QUERY' | 'MUTATION' | 'SUBSCRIPTION' }` (Optional filter)\n\n* **`describe_graphql_type`**\n * **Description:** Provides details about a specific GraphQL type (Object, Input, Scalar, Enum, Interface, Union) using schema introspection. Essential for understanding how to structure queries or mutations involving specific types.\n * **Input:** `{ typeName: string }` (Case-sensitive type name)\n\n* **`preview_table_data`**\n * **Description:** Fetches a limited sample of rows (default 5) from a specified table to preview its data structure and content. Selects common scalar and enum fields automatically.\n * **Input:** `{ tableName: string, limit?: number }`\n\n* **`aggregate_data`**\n * **Description:** Performs a simple aggregation (count, sum, avg, min, max) on a specified table, optionally applying a Hasura 'where' filter. Use 'list_tables' to find table names. Requires 'field' for non-count aggregations.\n * **Input:** `{ tableName: string, aggregateFunction: 'count'|'sum'|'avg'|'min'|'max', field?: string, filter?: object }`\n\n* **`health_check`**\n * **Description:** Checks if the configured Hasura GraphQL endpoint is reachable and responding to a basic GraphQL query (`{ __typename }`). Can optionally check a specific HTTP health endpoint URL if known.\n * **Input:** `{ healthEndpointUrl?: string }` (Optional specific health URL)\n\n## Requirements\n\n* Node.js (v18 or higher recommended, check `.nvmrc` or `package.json engines` if specified)\n* `pnpm` (or `npm`/`yarn`, adjust commands accordingly)\n* Access to a running Hasura GraphQL endpoint.\n* (Optional but recommended) Hasura Admin Secret for privileged access, or properly configured default role permissions.\n\n## Setup and Installation\n\n1. **Clone the Repository (if applicable):**\n ```bash\n # git clone \n # cd mcp-hasura-advanced\n ```\n2. **Install Dependencies:**\n ```bash\n pnpm install\n ```\n3. **Build the Server:**\n ```bash\n pnpm run build\n ```\n This compiles the TypeScript code into the `dist` directory.\n\n## Running the Server\n\nExecute the compiled script from your terminal, providing the Hasura endpoint URL and optionally the admin secret:\n\n```bash\n# Using pnpm start script (defined in package.json)\npnpm start [ADMIN_SECRET]\n\n# Or using Node directly\nnode dist/index.js [ADMIN_SECRET]\n```\n\n**Example:**\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\nor\n\n```bash\nnode dist/index.js https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\nIf no admin secret is needed (using default role permissions):\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql\n```\n\nThe server will start, attempt an initial schema introspection, connect to the STDIO transport, and log status messages to `stderr`. It listens for MCP JSON-RPC requests on `stdin` and sends responses to `stdout`.\n\n## Usage with MCP Clients (e.g., Cursor, Claude Desktop)\n\nTo connect this server to an MCP client like Cursor:\n\n1. **Find Absolute Paths:**\n * Node executable: Run `which node` in your terminal.\n * Server script: Navigate to the `mcp-hasura-advanced` directory and run `pwd`. Append `/dist/index.js` to the result.\n * Project directory: The output of `pwd`.\n2. **Configure the Client:** Open your client's configuration file (e.g., `settings.json` for Cursor, `claude_desktop_config.json` for Claude Desktop).\n3. **Add Server Entry:** Add an entry under the appropriate key (e.g., `cursor.customMcpServers` array for Cursor, `mcpServers` object for Claude Desktop).\n\n**Example Cursor `settings.json`:**\n\n```json\n{\n // ... other settings ...\n \"cursor.customMcpServers\": [\n // ... other servers ...\n {\n \"name\": \"My Advanced Hasura Server\", // Name shown in Cursor UI\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional but recommended for module resolution consistency:\n \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\" // <<< Absolute path to project root\n }\n ]\n}\n```\n\n**Example Claude Desktop `claude_desktop_config.json`:**\n\n```json\n{\n \"mcpServers\": {\n // ... other servers ...\n \"hasura-advanced\": { // Key used internally by Claude\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional:\n // \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\"\n }\n }\n}\n```\n\n4. **Replace Placeholders:** Update all placeholders (`/path/to/...`, `https://YOUR...`, `YOUR_ADMIN_SECRET`) with your actual values.\n5. **Restart/Reload Client:** Save the configuration and restart or reload your MCP client application.\n6. **Select Server:** Choose \"My Advanced Hasura Server\" (or the name you specified) in the client's UI.\n7. **Interact:** Use natural language prompts in your client's chat to leverage the server's tools (e.g., \"List tables using the Hasura server\", \"Describe the 'users' table\", \"Preview data from the 'orders' table\", \"Run the query `{ products { name price } }` using the Hasura server\").\n\n## Development\n\n* **Run in Dev Mode:** Use `pnpm run dev [SECRET]` to run the server directly with `ts-node` for faster iteration (no build step needed).\n* **Testing:** Test individual tools by running the server manually (`pnpm start ...`) and piping JSON-RPC requests to its `stdin`.\n","English","tag","en-US",{"_36":48,"_40":52,"_45":53},{"_38":49,"_40":50,"_42":51},"Un servidor de protocolo de contexto de modelo que permite a los agentes de IA interactuar dinámicamente con los puntos finales GraphQL de Hasura a través del lenguaje natural, lo que respalda el descubrimiento de esquemas, la consulta/manipulación de datos y las agregaciones.","Servidor MCP GraphQL de Hasura avanzado","# Servidor MCP GraphQL de Hasura avanzado\n\n**Versión:** 1.1.0\n\nEste servidor de Protocolo de Contexto de Modelo (MCP) proporciona una interfaz avanzada para que los agentes de IA (como los de Cursor o Claude Desktop) interactúen con un endpoint GraphQL de Hasura. Permite a los agentes descubrir la estructura de la API, ejecutar consultas de solo lectura y mutaciones (con precaución), previsualizar datos, realizar agregaciones y comprobar el estado del servicio.\n\nEste servidor mejora las capacidades de LLM al permitirles aprovechar su API Hasura de forma dinámica en función de solicitudes de lenguaje natural.\n\n## Características\n\nEste servidor expone las siguientes capacidades de MCP:\n\n**Recursos:**\n\n* **Esquema Hasura GraphQL ( `hasura:/schema` )**\n\n * Proporciona la definición completa del esquema GraphQL obtenida mediante introspección estándar.\n * **Tipo MIME:** `application/json`\n * Los agentes pueden leer este recurso para comprender la estructura completa de la API, incluidos tipos, campos, argumentos, directivas, etc.\n\n**Herramientas:**\n\n* **`run_graphql_query`**\n\n * **Descripción:** Ejecuta una consulta GraphQL de solo lectura en el endpoint de Hasura. Úselo para obtener datos cuando una herramienta específica no esté disponible. Asegúrese de que la consulta no modifique los datos. *Ejemplo: `query { users { id name } }`*\n * **Entrada:** `{ query: string, variables?: object }`\n * **Nota:** Realiza una comprobación básica para evitar la ejecución de cadenas que empiezan por `mutation` . Se basa principalmente en que la consulta sea de solo lectura.\n\n* **`run_graphql_mutation`**\n\n * **Descripción:** Ejecuta una mutación de GraphQL para insertar, actualizar o eliminar datos. **Úselo con precaución** y asegúrese de que la operación sea segura y esté diseñada para el propósito previsto. Depende de los permisos de Hasura configurados para el secreto de administrador proporcionado o el rol predeterminado. *Ejemplo: `mutation { insert_users_one(object: {name: \"Test\"}) { id } }`*\n * **Entrada:** `{ mutation: string, variables?: object }`\n * **Seguridad:** Permite cualquier mutación permitida por el rol de Hasura. Asegúrese de que los permisos de Hasura estén configurados correctamente.\n\n* **`list_tables`**\n\n * **Descripción:** Enumera las tablas (o colecciones) de datos disponibles gestionadas por Hasura, organizadas por esquema con descripciones, basándose en heurísticas de introspección (busca tipos de objeto con un campo 'id', excluyendo tipos internos/agregados). Útil para descubrir las fuentes de datos disponibles.\n * **Entrada:** `{ schemaName?: string }` (nombre de esquema opcional, intenta inferir a partir de las descripciones de los campos si es posible, el valor predeterminado es 'público' conceptualmente)\n\n* **`describe_table`**\n\n * **Descripción:** Muestra la estructura de una tabla específica incluyendo todas sus columnas (campos) con sus tipos y descripciones GraphQL.\n * **Entrada:** `{ tableName: string, schemaName?: string }`\n\n* **`list_root_fields`**\n\n * **Descripción:** Enumera los campos de consulta, mutación o suscripción de nivel superior disponibles en el esquema GraphQL. Resulta útil para comprender los principales puntos de entrada de las operaciones.\n * **Entrada:** `{ fieldType?: 'QUERY' | 'MUTATION' | 'SUBSCRIPTION' }` (Filtro opcional)\n\n* **`describe_graphql_type`**\n\n * **Descripción:** Proporciona detalles sobre un tipo específico de GraphQL (Objeto, Entrada, Escalar, Enumeración, Interfaz, Unión) mediante introspección de esquemas. Esencial para comprender cómo estructurar consultas o mutaciones que involucran tipos específicos.\n * **Entrada:** `{ typeName: string }` (nombre de tipo que distingue entre mayúsculas y minúsculas)\n\n* **`preview_table_data`**\n\n * **Descripción:** Obtiene una muestra limitada de filas (5 por defecto) de una tabla específica para previsualizar su estructura y contenido de datos. Selecciona automáticamente campos escalares y de enumeración comunes.\n * **Entrada:** `{ tableName: string, limit?: number }`\n\n* **`aggregate_data`**\n\n * **Descripción:** Realiza una agregación simple (conteo, suma, promedio, mínimo, máximo) en una tabla específica, aplicando opcionalmente un filtro \"donde\" de Hasura. Use \"list\\_tables\" para buscar nombres de tabla. Requiere \"campo\" para agregaciones sin conteo.\n * **Entrada:** `{ tableName: string, aggregateFunction: 'count'|'sum'|'avg'|'min'|'max', field?: string, filter?: object }`\n\n* **`health_check`**\n\n * **Descripción:** Comprueba si el punto final de Hasura GraphQL configurado es accesible y responde a una consulta básica de GraphQL ( `{ __typename }` ). Opcionalmente, puede comprobar la URL de un punto final de estado HTTP específico si se conoce.\n * **Entrada:** `{ healthEndpointUrl?: string }` (URL de salud específica opcional)\n\n## Requisitos\n\n* Node.js (se recomienda v18 o superior, verifique los motores `.nvmrc` o `package.json engines` si se especifican)\n* `pnpm` (o `npm` / `yarn` , ajuste los comandos según corresponda)\n* Acceso a un punto final GraphQL de Hasura en ejecución.\n* (Opcional pero recomendado) Secreto de administrador de Hasura para acceso privilegiado o permisos de rol predeterminados configurados correctamente.\n\n## Configuración e instalación\n\n1. **Clonar el repositorio (si corresponde):**\n\n ```bash\n # git clone \n # cd mcp-hasura-advanced\n ```\n\n2. **Dependencias de instalación:**\n\n ```bash\n pnpm install\n ```\n\n3. **Construir el servidor:**\n\n ```bash\n pnpm run build\n ```\n\n Esto compila el código TypeScript en el directorio `dist` .\n\n## Ejecución del servidor\n\nEjecute el script compilado desde su terminal, proporcionando la URL del punto final de Hasura y, opcionalmente, el secreto de administrador:\n\n```bash\n# Using pnpm start script (defined in package.json)\npnpm start [ADMIN_SECRET]\n\n# Or using Node directly\nnode dist/index.js [ADMIN_SECRET]\n```\n\n**Ejemplo:**\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\no\n\n```bash\nnode dist/index.js https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\nSi no se necesita ningún secreto de administrador (usando los permisos de rol predeterminados):\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql\n```\n\nEl servidor se iniciará, intentará una introspección inicial del esquema, se conectará al transporte STDIO y registrará los mensajes de estado en `stderr` . Escuchará las solicitudes JSON-RPC de MCP en `stdin` y enviará las respuestas a `stdout` .\n\n## Uso con clientes MCP (por ejemplo, Cursor, Claude Desktop)\n\nPara conectar este servidor a un cliente MCP como Cursor:\n\n1. **Encontrar rutas absolutas:**\n\n * Nodo ejecutable: ejecuta `which node` en tu terminal.\n * Script del servidor: Diríjase al directorio `mcp-hasura-advanced` y ejecute `pwd` . Añada `/dist/index.js` al resultado.\n * Directorio del proyecto: La salida de `pwd` .\n2. **Configurar el cliente:** abra el archivo de configuración de su cliente (por ejemplo, `settings.json` para Cursor, `claude_desktop_config.json` para Claude Desktop).\n3. **Agregar entrada de servidor:** agregue una entrada bajo la clave apropiada (por ejemplo, matriz `cursor.customMcpServers` para Cursor, objeto `mcpServers` para Claude Desktop).\n\n**Ejemplo `settings.json` del cursor.json:**\n\n```json\n{\n // ... other settings ...\n \"cursor.customMcpServers\": [\n // ... other servers ...\n {\n \"name\": \"My Advanced Hasura Server\", // Name shown in Cursor UI\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional but recommended for module resolution consistency:\n \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\" // <<< Absolute path to project root\n }\n ]\n}\n```\n\n**Ejemplo de Claude Desktop `claude_desktop_config.json` :**\n\n```json\n{\n \"mcpServers\": {\n // ... other servers ...\n \"hasura-advanced\": { // Key used internally by Claude\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional:\n // \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\"\n }\n }\n}\n```\n\n4. **Reemplazar marcadores de posición:** actualice todos los marcadores de posición ( `/path/to/...` , `https://YOUR...` , `YOUR_ADMIN_SECRET` ) con sus valores reales.\n5. **Reiniciar/Recargar cliente:** guarde la configuración y reinicie o recargue su aplicación cliente MCP.\n6. **Seleccionar servidor:** elija “Mi servidor Hasura avanzado” (o el nombre que especificó) en la interfaz de usuario del cliente.\n7. **Interactuar:** utilice indicaciones en lenguaje natural en el chat de su cliente para aprovechar las herramientas del servidor (por ejemplo, \"Enumerar tablas usando el servidor Hasura\", \"Describir la tabla 'usuarios'\", \"Obtener una vista previa de los datos de la tabla 'pedidos'\", \"Ejecutar la consulta `{ products { name price } }` usando el servidor Hasura\").\n\n## Desarrollo\n\n* **Ejecutar en modo de desarrollo:** use `pnpm run dev [SECRET]` para ejecutar el servidor directamente con `ts-node` para una iteración más rápida (no se necesita ningún paso de compilación).\n* **Pruebas:** pruebe herramientas individuales ejecutando el servidor manualmente ( `pnpm start ...` ) y canalizando solicitudes JSON-RPC a su `stdin` .","Spanish","es-ES",{"_36":55,"_40":59,"_45":60},{"_38":56,"_40":57,"_42":58},"AI エージェントが自然言語を通じて Hasura GraphQL エンドポイントと動的に対話し、スキーマの検出、データのクエリ/操作、および集約をサポートできるようにするモデルコンテキストプロトコルサーバー。","高度な Hasura GraphQL MCP サーバー","# 高度な Hasura GraphQL MCP サーバー\n\n**バージョン:** 1.1.0\n\nこのモデルコンテキストプロトコル（MCP）サーバーは、AIエージェント（CursorやClaude Desktopなど）がHasura GraphQLエンドポイントと対話するための高度なインターフェースを提供します。エージェントは、API構造の検出、読み取り専用クエリとミューテーション（注意して実行）、データのプレビュー、集計の実行、サービスの健全性チェックなどを行うことができます。\n\nこのサーバーは、自然言語のリクエストに基づいて Hasura API を動的に活用できるようにすることで、LLM 機能を強化します。\n\n## 特徴\n\nこのサーバーは、次の MCP 機能を公開します。\n\n**リソース：**\n\n* **Hasura GraphQL スキーマ ( `hasura:/schema` )**\n\n * 標準のイントロスペクションによって取得された完全な GraphQL スキーマ定義を提供します。\n * **MIMEタイプ:** `application/json`\n * エージェントはこのリソースを読んで、型、フィールド、引数、ディレクティブなどを含む API の完全な構造を理解できます。\n\n**ツール:**\n\n* **`run_graphql_query`**\n\n * **説明:** Hasuraエンドポイントに対して読み取り専用のGraphQLクエリを実行します。特定のツールが利用できない場合にデータを取得するために使用します。クエリによってデータが変更されないようにしてください。*例: `query { users { id name } }`*\n * **入力:** `{ query: string, variables?: object }`\n * **注:** `mutation`で始まる文字列の実行を防ぐための基本的なチェックを実行します。主にクエリ自体が読み取り専用であることを前提としています。\n\n* **`run_graphql_mutation`**\n\n * **説明:** GraphQLミューテーションを実行して、データを挿入、更新、または削除します。操作が意図されたものであり、安全であることを確認した上で、**慎重に使用してください**。指定された管理者シークレットまたはデフォルトのロールに設定されたHasura権限に依存します。*例: `mutation { insert_users_one(object: {name: \"Test\"}) { id } }`*\n * **入力:** `{ mutation: string, variables?: object }`\n * **セキュリティ:** Hasuraロールで許可されたすべての変更を許可します。適切なHasura権限が設定されていることを確認してください。\n\n* **`list_tables`**\n\n * **説明:** Hasura によって管理されている利用可能なデータテーブル（またはコレクション）を、イントロスペクションヒューリスティック（内部/集約型を除く、「id」フィールドを持つオブジェクト型を検索）に基づいて、スキーマと説明ごとに整理して一覧表示します。利用可能なデータソースの検出に役立ちます。\n * **入力:** `{ schemaName?: string }` (オプションのスキーマ名、可能な場合はフィールドの説明から推測を試みます。概念的にはデフォルトは「public」です)\n\n* **`describe_table`**\n\n * \\*\\*説明:\\*\\*特定のテーブルの構造を、そのすべての列 (フィールド) とその GraphQL タイプおよび説明とともに表示します。\n * **入力:** `{ tableName: string, schemaName?: string }`\n\n* **`list_root_fields`**\n\n * **説明:** GraphQLスキーマから利用可能な最上位レベルのクエリ、ミューテーション、またはサブスクリプションフィールドを一覧表示します。操作の主要なエントリポイントを理解するのに役立ちます。\n * **入力:** `{ fieldType?: 'QUERY' | 'MUTATION' | 'SUBSCRIPTION' }` (オプションのフィルター)\n\n* **`describe_graphql_type`**\n\n * \\*\\*説明:\\*\\*スキーマイントロスペクションを用いて、特定のGraphQL型（オブジェクト、入力、スカラー、列挙型、インターフェース、ユニオン）の詳細を提供します。特定の型を含むクエリやミューテーションの構造化方法を理解する上で不可欠です。\n * **入力:** `{ typeName: string }` (大文字と小文字を区別する型名)\n\n* **`preview_table_data`**\n\n * \\*\\*説明:\\*\\*指定されたテーブルから限られた行数（デフォルトは5行）のサンプルを取得し、そのデータ構造と内容をプレビューします。共通のスカラーフィールドと列挙型フィールドは自動的に選択されます。\n * **入力:** `{ tableName: string, limit?: number }`\n\n* **`aggregate_data`**\n\n * \\*\\*説明:\\*\\*指定されたテーブルに対して、単純な集計（count、sum、avg、min、max）を実行します。オプションでHasuraの「where」フィルターを適用できます。テーブル名を検索するには「list\\_tables」を使用してください。count以外の集計には「field」が必要です。\n * **入力:** `{ tableName: string, aggregateFunction: 'count'|'sum'|'avg'|'min'|'max', field?: string, filter?: object }`\n\n* **`health_check`**\n\n * \\*\\*説明:\\*\\*設定されたHasura GraphQLエンドポイントが到達可能であり、基本的なGraphQLクエリ( `{ __typename }` )に応答するかどうかを確認します。オプションで、特定のHTTPヘルスエンドポイントURLがわかっている場合は、そのURLをチェックすることもできます。\n * **入力:** `{ healthEndpointUrl?: string }` (オプションの特定のヘルス URL)\n\n## 要件\n\n* Node.js (v18 以上を推奨、指定されている場合は`.nvmrc`または`package.json engines`を確認してください)\n* `pnpm` (または`npm` / `yarn` 、コマンドは適宜調整してください)\n* 実行中の Hasura GraphQL エンドポイントへのアクセス。\n* (オプションですが推奨) 特権アクセス用の Hasura 管理者シークレット、または適切に構成されたデフォルトのロール権限。\n\n## セットアップとインストール\n\n1. **リポジトリをクローンします (該当する場合)。**\n\n ```bash\n # git clone \n # cd mcp-hasura-advanced\n ```\n\n2. **依存関係をインストールします:**\n\n ```bash\n pnpm install\n ```\n\n3. **サーバーを構築する:**\n\n ```bash\n pnpm run build\n ```\n\n これにより、TypeScript コードが`dist`ディレクトリにコンパイルされます。\n\n## サーバーの実行\n\nHasura エンドポイント URL とオプションで管理者シークレットを指定して、ターミナルからコンパイルされたスクリプトを実行します。\n\n```bash\n# Using pnpm start script (defined in package.json)\npnpm start [ADMIN_SECRET]\n\n# Or using Node directly\nnode dist/index.js [ADMIN_SECRET]\n```\n\n**例：**\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\nまたは\n\n```bash\nnode dist/index.js https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\n管理者シークレットが必要ない場合（デフォルトのロール権限を使用）：\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql\n```\n\nサーバーが起動し、初期のスキーマイントロスペクションを試行し、STDIOトランスポートに接続し、ステータスメッセージを`stderr`に記録します。stdin `stdin` MCP JSON-RPCリクエストをリッスンし、 `stdout`に応答を送信します。\n\n## MCP クライアント (例: Cursor、Claude Desktop) での使用\n\nこのサーバーを Cursor などの MCP クライアントに接続するには:\n\n1. **絶対パスを見つける:**\n\n * ノード実行ファイル: ターミナルで`which node`を実行します。\n * サーバースクリプト: `mcp-hasura-advanced`ディレクトリに移動し、 `pwd`を実行します。結果に`/dist/index.js`を追加します。\n * プロジェクトディレクトリ: `pwd`の出力。\n2. \\*\\*クライアントを構成する:\\*\\*クライアントの構成ファイルを開きます (例: Cursor の場合は`settings.json` 、Claude Desktop の場合は`claude_desktop_config.json` )。\n3. \\*\\*サーバーエントリの追加:\\*\\*適切なキーの下にエントリを追加します (例: Cursor の場合は`cursor.customMcpServers`配列、Claude Desktop の場合は`mcpServers`オブジェクト)。\n\n**カーソル`settings.json`例.json:**\n\n```json\n{\n // ... other settings ...\n \"cursor.customMcpServers\": [\n // ... other servers ...\n {\n \"name\": \"My Advanced Hasura Server\", // Name shown in Cursor UI\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional but recommended for module resolution consistency:\n \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\" // <<< Absolute path to project root\n }\n ]\n}\n```\n\n**Claude Desktop の例`claude_desktop_config.json` :**\n\n```json\n{\n \"mcpServers\": {\n // ... other servers ...\n \"hasura-advanced\": { // Key used internally by Claude\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional:\n // \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\"\n }\n }\n}\n```\n\n4. \\*\\*プレースホルダーの置き換え:\\*\\*すべてのプレースホルダー ( `/path/to/...` 、 `https://YOUR...` 、 `YOUR_ADMIN_SECRET` ) を実際の値に更新します。\n5. \\*\\*クライアントの再起動/リロード:\\*\\*構成を保存し、MCP クライアントアプリケーションを再起動またはリロードします。\n6. \\*\\*サーバーの選択:\\*\\*クライアントの UI で「My Advanced Hasura Server」(または指定した名前) を選択します。\n7. \\*\\*対話:\\*\\*クライアントのチャットで自然言語プロンプトを使用して、サーバーのツールを活用します (例: 「Hasura サーバーを使用してテーブルを一覧表示する」、「「users」テーブルについて説明する」、「「orders」テーブルからデータをプレビューする」、「Hasura サーバーを使用してクエリ`{ products { name price } }`を実行する」)。\n\n## 発達\n\n* **開発モードで実行:** `pnpm run dev [SECRET]`を使用して、 `ts-node`でサーバーを直接実行し、反復処理を高速化します (ビルドステップは不要)。\n* \\*\\*テスト:\\*\\*サーバーを手動で実行し ( `pnpm start ...` )、JSON-RPC リクエストを`stdin`にパイプして、個々のツールをテストします。","Japanese","ja-JP",{"_36":62,"_40":66,"_45":67},{"_38":63,"_40":64,"_42":65},"AI 에이전트가 자연어를 통해 Hasura GraphQL 엔드포인트와 동적으로 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 스키마 검색, 데이터 쿼리/조작, 집계를 지원합니다.","고급 Hasura GraphQL MCP 서버","# 고급 Hasura GraphQL MCP 서버\n\n**버전:** 1.1.0\n\n이 모델 컨텍스트 프로토콜(MCP) 서버는 AI 에이전트(Cursor 또는 Claude Desktop 등)가 Hasura GraphQL 엔드포인트와 상호 작용할 수 있도록 고급 인터페이스를 제공합니다. 이를 통해 에이전트는 API 구조를 파악하고, 읽기 전용 쿼리와 뮤테이션(주의 필요)을 모두 실행하고, 데이터를 미리 보고, 집계를 수행하고, 서비스 상태를 확인할 수 있습니다.\n\n이 서버는 자연어 요청에 따라 Hasura API를 동적으로 활용할 수 있도록 하여 LLM 기능을 향상시킵니다.\n\n## 특징\n\n이 서버는 다음과 같은 MCP 기능을 제공합니다.\n\n**자원:**\n\n* **Hasura GraphQL 스키마( `hasura:/schema` )**\n\n * 표준 인트로스펙션을 통해 얻은 전체 GraphQL 스키마 정의를 제공합니다.\n * **MIME 유형:** `application/json`\n * 에이전트는 이 리소스를 읽고 유형, 필드, 인수, 지침 등을 포함한 API의 전체 구조를 이해할 수 있습니다.\n\n**도구:**\n\n* **`run_graphql_query`**\n\n * **설명:** Hasura 엔드포인트에 대해 읽기 전용 GraphQL 쿼리를 실행합니다. 특정 도구를 사용할 수 없을 때 데이터를 가져오는 데 사용합니다. 쿼리가 데이터를 수정하지 않도록 합니다. *예: `query { users { id name } }`*\n * **입력:** `{ query: string, variables?: object }`\n * **참고:** `mutation` 으로 시작하는 문자열의 실행을 방지하기 위한 기본 검사를 수행합니다. 주로 쿼리 자체가 읽기 전용인지 확인합니다.\n\n* **`run_graphql_mutation`**\n\n * **설명:** GraphQL 뮤테이션을 실행하여 데이터를 삽입, 업데이트 또는 삭제합니다. **주의해서 사용하고** , 작업이 의도된 대로 안전하게 수행되는지 확인하십시오. 제공된 관리자 비밀번호 또는 기본 역할에 대해 구성된 Hasura 권한을 사용합니다. *예: `mutation { insert_users_one(object: {name: \"Test\"}) { id } }`*\n * **입력:** `{ mutation: string, variables?: object }`\n * **보안:** Hasura 역할에 따라 허용되는 모든 변형을 허용합니다. 적절한 Hasura 권한이 구성되어 있는지 확인하세요.\n\n* **`list_tables`**\n\n * **설명:** Hasura에서 관리하는 사용 가능한 데이터 테이블(또는 컬렉션)을 스키마별로 설명과 함께 정리하여 나열합니다. 이는 내부/집계 유형을 제외하고 'id' 필드가 있는 객체 유형을 찾습니다. 사용 가능한 데이터 소스를 찾는 데 유용합니다.\n * **입력:** `{ schemaName?: string }` (선택적 스키마 이름, 가능한 경우 필드 설명에서 추론을 시도하며, 개념적으로는 'public'으로 기본 설정됨)\n\n* **`describe_table`**\n\n * **설명:** GraphQL 유형과 설명과 함께 모든 열(필드)을 포함한 특정 테이블의 구조를 보여줍니다.\n * **입력:** `{ tableName: string, schemaName?: string }`\n\n* **`list_root_fields`**\n\n * **설명:** GraphQL 스키마에서 사용 가능한 최상위 쿼리, 뮤테이션 또는 구독 필드를 나열합니다. 작업의 주요 진입점을 이해하는 데 유용합니다.\n * **입력:** `{ fieldType?: 'QUERY' | 'MUTATION' | 'SUBSCRIPTION' }` (선택적 필터)\n\n* **`describe_graphql_type`**\n\n * **설명:** 스키마 인트로스펙션을 사용하여 특정 GraphQL 유형(객체, 입력, 스칼라, 열거형, 인터페이스, 공용체)에 대한 세부 정보를 제공합니다. 특정 유형과 관련된 쿼리 또는 뮤테이션을 구성하는 방법을 이해하는 데 필수적입니다.\n * **입력:** `{ typeName: string }` (대소문자 구분 유형 이름)\n\n* **`preview_table_data`**\n\n * **설명:** 지정된 테이블에서 제한된 행 샘플(기본값 5개)을 가져와 데이터 구조와 내용을 미리 봅니다. 공통 스칼라 및 열거형 필드를 자동으로 선택합니다.\n * **입력:** `{ tableName: string, limit?: number }`\n\n* **`aggregate_data`**\n\n * **설명:** 지정된 테이블에 대해 간단한 집계(개수, 합계, 평균, 최소값, 최대값)를 수행합니다. 선택적으로 Hasura 'where' 필터를 적용할 수 있습니다. 테이블 이름을 찾으려면 'list\\_tables'를 사용하세요. 개수 집계가 아닌 집계에는 'field'가 필요합니다.\n * **입력:** `{ tableName: string, aggregateFunction: 'count'|'sum'|'avg'|'min'|'max', field?: string, filter?: object }`\n\n* **`health_check`**\n\n * **설명:** 구성된 Hasura GraphQL 엔드포인트에 접근 가능하고 기본 GraphQL 쿼리( `{ __typename }` )에 응답하는지 확인합니다. 특정 HTTP 상태 엔드포인트 URL이 알려진 경우 선택적으로 해당 URL을 확인할 수 있습니다.\n * **입력:** `{ healthEndpointUrl?: string }` (선택적 특정 건강 URL)\n\n## 요구 사항\n\n* Node.js(v18 이상 권장, 지정된 경우 `.nvmrc` 또는 `package.json engines` 확인)\n* `pnpm` (또는 `npm` / `yarn` , 명령을 적절히 조정하세요)\n* 실행 중인 Hasura GraphQL 엔드포인트에 액세스합니다.\n* (선택 사항이지만 권장) 특권 액세스를 위한 Hasura 관리자 비밀번호 또는 올바르게 구성된 기본 역할 권한.\n\n## 설정 및 설치\n\n1. **저장소를 복제합니다(해당되는 경우):**\n\n 지엑스피1\n\n2. **종속성 설치:**\n\n ```bash\n pnpm install\n ```\n\n3. **서버 구축:**\n\n ```bash\n pnpm run build\n ```\n\n 이렇게 하면 TypeScript 코드가 `dist` 디렉토리로 컴파일됩니다.\n\n## 서버 실행\n\n터미널에서 컴파일된 스크립트를 실행하고 Hasura 엔드포인트 URL과 선택적으로 관리자 비밀번호를 제공합니다.\n\n```bash\n# Using pnpm start script (defined in package.json)\npnpm start [ADMIN_SECRET]\n\n# Or using Node directly\nnode dist/index.js [ADMIN_SECRET]\n```\n\n**예:**\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\n또는\n\n```bash\nnode dist/index.js https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\n관리자 비밀번호가 필요하지 않은 경우(기본 역할 권한 사��):\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql\n```\n\n서버가 시작되고, 초기 스키마 검사를 시도하고, STDIO 전송에 연결하고, `stderr` 에 상태 메시지를 로깅합니다. `stdin` 에서 MCP JSON-RPC 요청을 수신하고 `stdout` 으로 응답을 전송합니다.\n\n## MCP 클라이언트(예: Cursor, Claude Desktop)와 함께 사용\n\n이 서버를 Cursor와 같은 MCP 클라이언트에 연결하려면:\n\n1. **절대 경로 찾기:**\n\n * 노드 실행 파일: 터미널에서 `which node` 실행하나요?\n * 서버 스크립트: `mcp-hasura-advanced` 디렉터리로 이동하여 `pwd` 실행합니다. 결과에 `/dist/index.js` 추가합니다.\n * 프로젝트 디렉토리: `pwd` 의 출력.\n2. **클라이언트 구성:** 클라이언트의 구성 파일을 엽니다(예: Cursor의 경우 `settings.json` , Claude Desktop의 경우 `claude_desktop_config.json` ).\n3. **서버 항목 추가:** 적절한 키 아래에 항목을 추가합니다(예: Cursor의 경우 `cursor.customMcpServers` 배열, Claude Desktop의 경우 `mcpServers` 개체).\n\n**예제 커서 `settings.json` :**\n\n```json\n{\n // ... other settings ...\n \"cursor.customMcpServers\": [\n // ... other servers ...\n {\n \"name\": \"My Advanced Hasura Server\", // Name shown in Cursor UI\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional but recommended for module resolution consistency:\n \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\" // <<< Absolute path to project root\n }\n ]\n}\n```\n\n**예시 Claude Desktop `claude_desktop_config.json` :**\n\n```json\n{\n \"mcpServers\": {\n // ... other servers ...\n \"hasura-advanced\": { // Key used internally by Claude\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional:\n // \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\"\n }\n }\n}\n```\n\n4. **플레이스홀더 바꾸기:** 모든 플레이스홀더( `/path/to/...` , `https://YOUR...` , `YOUR_ADMIN_SECRET` )를 실제 값으로 업데이트합니다.\n5. **클라이언트 재시작/다시 로드:** 구성을 저장하고 MCP 클라이언트 애플리케이션을 재시작하거나 다시 로드합니다.\n6. **서버 선택:** 클라이언트 UI에서 \"내 고급 하수라 서버\"(또는 지정한 이름)를 선택합니다.\n7. **상호작용:** 클라이언트의 채팅에서 자연어 프롬프트를 사용하여 서버 도구를 활용합니다(예: \"Hasura 서버를 사용하여 테이블 나열\", \"'users' 테이블 설명\", \"'orders' 테이블에서 데이터 미리 보기\", \"Hasura 서버를 사용하여 `{ products { name price } }` 쿼리 실행\").\n\n## 개발\n\n* **개발 모드에서 실행:** `pnpm run dev [SECRET]` 사용하여 `ts-node` 로 직접 서버를 실행하면 더 빠른 반복이 가능합니다(빌드 단계가 필요하지 않음).\n* **테스트:** 서버를 수동으로 실행( `pnpm start ...` )하고 JSON-RPC 요청을 `stdin` 으로 파이프하여 개별 도구를 테스트합니다.","Korean","ko-KR",{"_36":69,"_40":73,"_45":74},{"_38":70,"_40":71,"_42":72},"模型上下文协议服务器，使 AI 代理能够通过自然语言与 Hasura GraphQL 端点动态交互，支持模式发现、数据查询/操作和聚合。","高级 Hasura GraphQL MCP 服务器","# 高级 Hasura GraphQL MCP 服务器\n\n**版本：** 1.1.0\n\n该模型上下文协议 (MCP) 服务器为 AI 代理（例如 Cursor 或 Claude Desktop 中的代理）提供了一个高级接口，用于与 Hasura GraphQL 端点交互。它使代理能够发现 API 结构、执行只读查询和变更（需谨慎操作）、预览数据、执行聚合以及检查服务运行状况。\n\n该服务器允许他们根据自然语言请求动态利用您的 Hasura API，从而增强了 LLM 功能。\n\n## 特征\n\n该服务器公开以下 MCP 功能：\n\n**资源：**\n\n* **Hasura GraphQL 架构 ( `hasura:/schema` )**\n\n * 提供通过标准自省获得的完整 GraphQL 模式定义。\n * **MIME 类型：** `application/json`\n * 代理可以阅读此资源来了解 API 的完整结构，包括类型、字段、参数、指令等。\n\n**工具：**\n\n* **`run_graphql_query`**\n\n * \\*\\*描述：\\*\\*针对 Hasura 端点执行只读 GraphQL 查询。当特定工具不可用时，使用此方法获取数据。确保查询不会修改数据。*示例： `query { users { id name } }`*\n * **输入：** `{ query: string, variables?: object }`\n * \\*\\*注意：\\*\\*执行基本检查以防止执行以`mutation`开头的字符串。主要依赖于查询本身是否为只读。\n\n* **`run_graphql_mutation`**\n\n * \\*\\*描述：\\*\\*执行 GraphQL 突变以插入、更新或删除数据。**请谨慎使用**，确保操作符合预期且安全。依赖于为提供的管理员密钥或默认角色配置的 Hasura 权限。*示例： `mutation { insert_users_one(object: {name: \"Test\"}) { id } }`*\n * **输入：** `{ mutation: string, variables?: object }`\n * \\*\\*安全性：\\*\\*允许 Hasura 角色允许的任何变更。确保配置了适当的 Hasura 权限。\n\n* **`list_tables`**\n\n * \\*\\*描述：\\*\\*列出 Hasura 管理的可用数据表（或集合），并根据自省启发式方法（查找带有“id”字段的对象类型，不包括内部/聚合类型）按模式组织，并附带描述。有助于发现可用的数据源。\n * **输入：** `{ schemaName?: string }` （可选模式名称，如果可能则尝试从字段描述中推断，概念上默认为“公共”）\n\n* **`describe_table`**\n\n * \\*\\*描述：\\*\\*显示特定表的结构，包括其所有列（字段）及其 GraphQL 类型和描述。\n * **输入：** `{ tableName: string, schemaName?: string }`\n\n* **`list_root_fields`**\n\n * \\*\\*描述：\\*\\*列出 GraphQL 架构中可用的顶级查询、变更或订阅字段。有助于理解操作的主要入口点。\n * **输入：** `{ fieldType?: 'QUERY' | 'MUTATION' | 'SUBSCRIPTION' }` （可选过滤器）\n\n* **`describe_graphql_type`**\n\n * \\*\\*描述：\\*\\*使用模式自省提供有关特定 GraphQL 类型（对象、输入、标量、枚举、接口、联合）的详细信息。对于理解如何构建涉及特定类型的查询或修改至关重要。\n * **输入：** `{ typeName: string }` （区分大小写的类型名称）\n\n* **`preview_table_data`**\n\n * \\*\\*描述：\\*\\*从指定表中获取有限行样本（默认 5 行），以预览其数据结构和内容。自动选择常用标量和枚举字段。\n * **输入：** `{ tableName: string, limit?: number }`\n\n* **`aggregate_data`**\n\n * \\*\\*描述：\\*\\*对指定表执行简单聚合（计数、求和、平均、最小值、最大值），可选择应用 Hasura 的“where”过滤器。使用“list\\_tables”查找表名。非计数聚合需要“field”。\n * **输入：** `{ tableName: string, aggregateFunction: 'count'|'sum'|'avg'|'min'|'max', field?: string, filter?: object }`\n\n* **`health_check`**\n\n * \\*\\*描述：\\*\\*检查配置的 Hasura GraphQL 端点是否可访问并响应基本 GraphQL 查询 ( `{ __typename }` )。如果已知，可以选择检查特定的 HTTP 健康端点 URL。\n * **输入：** `{ healthEndpointUrl?: string }` （可选具体健康 URL）\n\n## 要求\n\n* Node.js（建议使用 v18 或更高版本，如果指定，请检查`.nvmrc`或`package.json engines` ）\n* `pnpm` (或`npm` / `yarn` ，相应调整命令)\n* 访问正在运行的 Hasura GraphQL 端点。\n* （可选但推荐）Hasura 管理员机密用于特权访问，或正确配置的默认角色权限。\n\n## 设置和安装\n\n1. **克隆存储库（如果适用）：**\n\n ```bash\n # git clone \n # cd mcp-hasura-advanced\n ```\n\n2. **安装依赖项：**\n\n ```bash\n pnpm install\n ```\n\n3. **构建服务器：**\n\n ```bash\n pnpm run build\n ```\n\n 这会将 TypeScript 代码编译到`dist`目录中。\n\n## 运行服务器\n\n从您的终端执行已编译的脚本，提供 Hasura 端点 URL 和可选的管理员机密：\n\n```bash\n# Using pnpm start script (defined in package.json)\npnpm start [ADMIN_SECRET]\n\n# Or using Node directly\nnode dist/index.js [ADMIN_SECRET]\n```\n\n**例子：**\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\n或者\n\n```bash\nnode dist/index.js https://my-hasura.cloud/v1/graphql mysecretkey123\n```\n\n如果不需要管理员机密（使用默认角色权限）：\n\n```bash\npnpm start https://my-hasura.cloud/v1/graphql\n```\n\n服务器将启动，尝试进行初始模式自检，连接到 STDIO 传输，并将状态消息记录到`stderr` 。它会在`stdin`上监听 MCP JSON-RPC 请求，并将响应发送到`stdout` 。\n\n## 与 MCP 客户端一起使用（例如 Cursor、Claude Desktop）\n\n要将此服务器连接到 MCP 客户端（如 Cursor）：\n\n1. **查找绝对路径：**\n\n * 节点可执行文件：在终端中运行`which node` 。\n * 服务器脚本：导航到`mcp-hasura-advanced`目录并运行`pwd` 。将`/dist/index.js`附加到结果中。\n * 项目目录： `pwd`的输出。\n2. \\*\\*配置客户端：\\*\\*打开客户端的配置文件（例如，Cursor 的`settings.json` 、Claude Desktop 的`claude_desktop_config.json` ）。\n3. \\*\\*添加服务器条目：\\*\\*在适当的键下添加一个条目（例如，Cursor 的`cursor.customMcpServers`数组，Claude Desktop 的`mcpServers`对象）。\n\n**示例游标`settings.json` ：**\n\n```json\n{\n // ... other settings ...\n \"cursor.customMcpServers\": [\n // ... other servers ...\n {\n \"name\": \"My Advanced Hasura Server\", // Name shown in Cursor UI\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional but recommended for module resolution consistency:\n \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\" // <<< Absolute path to project root\n }\n ]\n}\n```\n\n**示例 Claude Desktop `claude_desktop_config.json` ：**\n\n```json\n{\n \"mcpServers\": {\n // ... other servers ...\n \"hasura-advanced\": { // Key used internally by Claude\n \"command\": \"/path/to/your/node\", // <<< Absolute path from 'which node'\n \"args\": [\n \"/absolute/path/to/mcp-hasura-advanced/dist/index.js\", // <<< Absolute path to compiled script\n \"https://YOUR_HASURA_ENDPOINT.com/v1/graphql\", // <<< Your endpoint\n \"YOUR_ADMIN_SECRET\" // <<< Your secret (REMOVE if no secret)\n ],\n // Optional:\n // \"cwd\": \"/absolute/path/to/mcp-hasura-advanced\"\n }\n }\n}\n```\n\n4. \\*\\*替换占位符：\\*\\*用您的实际值更新所有占位符（ `/path/to/...` 、 `https://YOUR...` 、 `YOUR_ADMIN_SECRET` ）。\n5. \\*\\*重启/重新加载客户端：\\*\\*保存配置并重启或重新加载您的 MCP 客户端应用程序。\n6. \\*\\*选择服务器：\\*\\*在客户端的 UI 中选择“我的高级 Hasura 服务器”（或您指定的名称）。\n7. \\*\\*互动：\\*\\*在客户的聊天中使用自然语言提示来利用服务器的工具（例如，“使用 Hasura 服务器列出表格”、“描述‘用户’表格”、“预览‘订单’表格中的数据”、“使用 Hasura 服务器运行查询`{ products { name price } }` ”）。\n\n## 发展\n\n* \\*\\*以开发模式运行：\\*\\*使用`pnpm run dev [SECRET]`直接通过`ts-node`运行服务器以实现更快的迭代（无需构建步骤）。\n* \\*\\*测试：\\*\\*通过手动运行服务器（ `pnpm start ...` ）并将 JSON-RPC 请求传送到其`stdin`来测试各个工具。","Chinese","zh-CN","githubUser","locale",{"_78":79,"_20":80,"_89":39,"_90":39,"_23":91,"_92":93,"_40":41,"_111":112,"_114":-5,"_115":116,"_147":148,"_153":-5,"_100":132,"_154":155,"_8":156,"_157":158},"addedAt","2025-04-07T18:05:29.665665394Z",[81,82,83,84,85,86,87,88],"category:databases","category:code-execution","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","license_grade:f","descriptionMarkdown","descriptionPlainText",5122,"integrations",[94,104],{"_95":96,"_38":102,"_8":103},"brand",{"_97":98,"_40":99,"_100":101},"logoSvgPath","M12.002 0a2.138 2.138 0 1 0 0 4.277 2.138 2.138 0 1 0 0-4.277zm8.54 4.931a2.138 2.138 0 1 0 0 4.277 2.138 2.138 0 1 0 0-4.277zm0 9.862a2.138 2.138 0 1 0 0 4.277 2.138 2.138 0 1 0 0-4.277zm-8.54 4.931a2.138 2.138 0 1 0 0 4.276 2.138 2.138 0 1 0 0-4.276zm-8.542-4.93a2.138 2.138 0 1 0 0 4.276 2.138 2.138 0 1 0 0-4.277zm0-9.863a2.138 2.138 0 1 0 0 4.277 2.138 2.138 0 1 0 0-4.277zm8.542-3.378L2.953 6.777v10.448l9.049 5.224 9.047-5.224V6.777zm0 1.601 7.66 13.27H4.34zm-1.387.371L3.97 15.037V7.363zm2.774 0 6.646 3.838v7.674zM5.355 17.44h13.293l-6.646 3.836z","GraphQL","slug","graphql","Enables execution of GraphQL queries and mutations against a Hasura endpoint, with support for introspection, type exploration, and schema analysis.","c8jplaaba9",{"_95":105,"_38":109,"_8":110},{"_97":106,"_40":107,"_100":108},"M23.558 8.172c.707-2.152.282-6.447-1.09-8.032a.419.419 0 0 0-.664.051l-1.69 2.59a1.322 1.322 0 0 1-1.737.276C16.544 1.885 14.354 1.204 12 1.204s-4.544.68-6.378 1.853a1.326 1.326 0 0 1-1.736-.276L2.196.191A.42.42 0 0 0 1.532.14C.16 1.728-.265 6.023.442 8.172c.236.716.3 1.472.16 2.207-.137.73-.276 1.61-.276 2.223C.326 18.898 5.553 24 11.997 24c6.447 0 11.671-5.105 11.671-11.398 0-.613-.138-1.494-.276-2.223a4.468 4.468 0 0 1 .166-2.207zm-11.56 13.284c-4.984 0-9.036-3.96-9.036-8.827 0-.16.005-.316.014-.473.18-3.316 2.243-6.15 5.16-7.5 1.17-.546 2.481-.848 3.864-.848s2.69.302 3.864.85c2.917 1.351 4.98 4.187 5.16 7.501.008.157.014.316.014.473-.003 4.864-4.057 8.824-9.04 8.824zm3.915-5.43-2.31-3.91-1.98-3.26a.26.26 0 0 0-.223-.125H9.508a.26.26 0 0 0-.227.13.246.246 0 0 0 .003.254l1.895 3.109-2.542 3.787a.25.25 0 0 0-.011.259.26.26 0 0 0 .23.132h1.905a.259.259 0 0 0 .218-.116l1.375-2.096 1.233 2.088a.263.263 0 0 0 .224.127h1.878c.094 0 .18-.049.224-.127a.241.241 0 0 0 0-.251z","Hasura","hasura","Provides tools for interacting with a Hasura GraphQL endpoint, enabling access to schema information, executing queries and mutations, managing tables, previewing data, and performing aggregations.","a3p4jgbx1f","namespace",{"_100":113},"husamabusafa","redditPostExternalId","repository",{"_117":-5,"_118":119,"_122":123,"_142":-5,"_143":144,"_145":-5,"_146":-5},"argumentsJsonSchema","githubProject",{"_42":43,"_120":121},"url","https://github.com/husamabusafa/hasura_mcp","githubRepository",{"_124":125,"_126":127,"_128":129,"_130":131,"_40":132,"_133":134,"_137":138,"_139":-5,"_140":141},"defaultBranch","main","fullName","husamabusafa/hasura_mcp","githubTreeId",105980,"language","TypeScript","hasura_mcp","owner",{"_135":113,"_8":136},"login","GekhY1z2mB","recentStargazers",0,"spdxLicense","stargazers",11,"glamaJson","inspectable",true,"npmPackage","supportedPlatforms","scores",{"_149":138,"_150":151,"_152":151},"license","quality",100,"security","simpleIcon","toolCount",9,"uzsb88xm6d","updatedAt","2025-08-12T17:50:46.933933910Z","meta",[161,163,165,172,175,177,180,183,186,189,192,194,197,200,202,204,206,208,210],{"_10":162},"Advanced Hasura GraphQL MCP Server | Glama",{"_164":39,"_40":38},"content",{"_166":167,"_168":169,"_170":171},"href","https://glama.ai/mcp/servers/@husamabusafa/hasura_mcp","rel","canonical","tagName","link",{"_164":41,"_173":174},"property","og:title",{"_164":39,"_173":176},"og:description",{"_164":178,"_173":179},"https://glama.ai/logo.png","og:logo",{"_164":181,"_173":182},"https://glama.ai/mcp/servers/@husamabusafa/hasura_mcp/og-image","og:image",{"_164":184,"_173":185},"630","og:image:height",{"_164":187,"_173":188},"1200","og:image:width",{"_164":190,"_173":191},"website","og:type",{"_164":167,"_173":193},"og:url",{"_164":195,"_173":196},"Glama – MCP Hosting Platform","og:site_name",{"_164":198,"_40":199},"summary_large_image","twitter:card",{"_164":195,"_40":201},"twitter:title",{"_164":39,"_40":203},"twitter:description",{"_164":181,"_40":205},"twitter:image",{"_164":184,"_40":207},"twitter:image:height",{"_164":187,"_40":209},"twitter:image:width",{"_211":212},"script:ld+json",{"_213":214,"_215":216},"@context","http://schema.org","@graph",[217],{"_213":218,"_219":220,"_221":222},"https://schema.org","@type","BreadcrumbList","itemListElement",[223,230,234,238],{"_219":224,"_225":226,"_40":227,"_228":229},"ListItem","item","/","Glama","position",1,{"_219":224,"_225":231,"_40":232,"_228":233},"/mcp","MCP",2,{"_219":224,"_225":235,"_40":236,"_228":237},"/mcp/servers","Servers",3,{"_219":224,"_225":239,"_40":41,"_228":240},"/mcp/servers/@husamabusafa/hasura_mcp",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_75":-5,"_36":245,"_159":258,"_294":-5},{"_78":79,"_20":246,"_89":39,"_90":39,"_23":91,"_92":247,"_40":41,"_111":252,"_114":-5,"_115":253,"_147":257,"_153":-5,"_100":132,"_154":155,"_8":156,"_157":158},[81,82,83,84,85,86,87,88],[248,250],{"_95":249,"_38":102,"_8":103},{"_97":98,"_40":99,"_100":101},{"_95":251,"_38":109,"_8":110},{"_97":106,"_40":107,"_100":108},{"_100":113},{"_117":-5,"_118":254,"_122":255,"_142":-5,"_143":144,"_145":-5,"_146":-5},{"_42":43,"_120":121},{"_124":125,"_126":127,"_128":129,"_130":131,"_40":132,"_133":256,"_137":138,"_139":-5,"_140":141},{"_135":113,"_8":136},{"_149":138,"_150":151,"_152":151},[259,261,263,265,267,268,269,270,271,272,273,274,275,276,277,278,279,280,281],{"_10":260},"Reviews | Advanced Hasura GraphQL MCP Server | Glama",{"_164":262,"_40":38},"Read community reviews and feedback for Advanced Hasura GraphQL MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_166":264,"_168":169,"_170":171},"https://glama.ai/mcp/servers/@husamabusafa/hasura_mcp/reviews",{"_164":266,"_173":174},"Reviews | Advanced Hasura GraphQL MCP Server",{"_164":262,"_173":176},{"_164":178,"_173":179},{"_164":181,"_173":182},{"_164":184,"_173":185},{"_164":187,"_173":188},{"_164":190,"_173":191},{"_164":264,"_173":193},{"_164":195,"_173":196},{"_164":198,"_40":199},{"_164":195,"_40":201},{"_164":262,"_40":203},{"_164":181,"_40":205},{"_164":184,"_40":207},{"_164":187,"_40":209},{"_211":282},{"_213":214,"_215":283},[284],{"_213":218,"_219":220,"_221":285},[286,287,288,289,290],{"_219":224,"_225":226,"_40":227,"_228":229},{"_219":224,"_225":231,"_40":232,"_228":233},{"_219":224,"_225":235,"_40":236,"_228":237},{"_219":224,"_225":239,"_40":41,"_228":240},{"_219":224,"_225":291,"_40":292,"_228":293},"/mcp/servers/@husamabusafa/hasura_mcp/reviews","Reviews",5,"review","actionData","errors"]

MCP directory API