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ámetroqueryy un parámetro descriptivoname. -
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
.envdel proyecto. Las variables esenciales incluyen:INSTANT_APP_IDINSTANT_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.