InstantDB

Un servidor MCP para interactuar con InstantDB, una base de datos en tiempo real.

Documentación

Servidor MCP instantdb-server

Un servidor MCP para interactuar con InstantDB.

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

Características

Herramientas

  • get_examples
    Devuelve ejemplos de consultas predefinidos para varias categorías (por ejemplo, "basic_read", "filtering", "associations").

  • queryDB
    Ejecuta una consulta específica contra InstantDB. Requiere un parámetro query y un parámetro descriptivo name.

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

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

Integración de Esquema y Entorno

  • Carga dinámica del esquema de 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 variables de entorno se carga desde el archivo .env del proyecto. Las variables esenciales incluyen:
    • INSTANT_APP_ID
    • INSTANT_APP_ADMIN_TOKEN

Características Pendientes

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

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para usar el servidor con Claude Desktop, agregue la siguiente configuración a su 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, use el Inspector MCP:

npm run inspector

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