Servidor MCP de instantdb-server

Un servidor MCP para interactuar con InstantDB.

Este servidor proporciona una interfaz de solo lectura para consultar InstantDB mediante un esquema cargado dinámicamente y una configuración de entorno. Incluye herramientas para ejecutar consultas y recuperar ejemplos de consultas basados en patrones predefinidos.

Características

Herramientas

• obtener_ejemplos
  Devuelve consultas de ejemplo predefinidas para varias categorías (por ejemplo, "basic_read", "filtrado", "asociaciones").

• consultaDB
  Ejecuta una consulta específica en InstantDB. Requiere una consulta y un parámetro de nombre descriptivo.

• listas_consultas
  Recupera el historial de consultas ejecutadas con detalles como ID de consulta, nombre, marca de tiempo y estructura.

• consulta de retorno
  Recupera una consulta específica por su ID único para referencia o implementación posterior.

Integración de esquemas y entornos

• Carga dinámica del esquema InstantDB desde ubicaciones de archivos comunes relativas a un directorio de proyecto proporcionado (por ejemplo, instant.schema.ts, src/instant.schema.ts, app/instant.schema.ts).

• La configuración de las variables de entorno se carga desde el archivo .env del proyecto. Las variables esenciales incluyen:

  • ID DE APLICACIÓN INSTANTÁNEA

  • TOKEN DE ADMINISTRADOR DE APLICACIONES INSTANTÁNEAS

Funciones pendientes

• Detección dinámica del archivo de permisos InstantDB desde ubicaciones de archivos comunes.

Related MCP server: mysql-mcp-server

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para utilizar el servidor con Claude Desktop, agregue la siguiente configuración a la configuración de Claude Desktop:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json

Ejemplo de configuración:

{
  "mcpServers": {
    "instantdb-server": {
      "command": "node",
      "args": ["/path/to/instantdb-server/build/index.js"],
      "env": {
        "INSTANT_APP_ID": "your_app_id",
        "INSTANT_APP_ADMIN_TOKEN": "your_admin_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Depuración

Para depurar las comunicaciones del servidor MCP, utilice el Inspector MCP:

npm run inspector

El Inspector proporcionará una URL para acceder a herramientas para monitorear las operaciones del servidor MCP.