MCP Servidor
Controle su backend Aurabase desde Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code o cualquier cliente compatible con Model Context Protocol: 86 herramientas, sin valor de fabricación.
Modo stdio local por defecto, modo HTTP local#
El servidor oficial Aurabase MCP expone 86 herramientas para inspeccionar y controlar su backend (82 con una clave de proyecto). Se ejecuta en su máquina, en uno de dos modos:
- modo stdio (predeterminado): su cliente MCP inicia el servidor como un subproceso con
npx. - Modo HTTP (HTTP transmitible): inicia un servidor local (
http://127.0.0.1:3001/mcp) y apunta a cada cliente a su URL.
El servicio alojado (https://mcp.aurabase.dev/mcp, inicie sesión con OAuth 2.1) está planificado, aún no está disponible.
El paquete tiene dos binarios (aurabase-mcp y aurabase-mcp-hosted), por lo que npx necesita el nombre binario: npx -y -p @aurabase/mcp-server aurabase-mcp. Se requiere --project-id.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
Para iniciar el servidor HTTP local, agregue el transporte, el puerto y el token:
npx -y -p @aurabase/mcp-server aurabase-mcp \
--transport http \
--port 3001 \
--auth-token my_secret_token \
--url http://localhost:8080 \
--project-id <uuid> \
--service-role-key aura_sk_…
Configuración por cliente y por modo#
modo stdio (predeterminado)
Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) y VS Code con Cline o Roo Code (cline_mcp_settings.json) usan el mismo bloque:
{
"mcpServers": {
"aurabase": {
"command": "npx",
"args": ["-y", "-p", "@aurabase/mcp-server", "aurabase-mcp"],
"env": {
"AURABASE_URL": "https://<slug>.aurabase.cloud",
"AURABASE_PROJECT_ID": "<uuid>",
"AURABASE_SERVICE_ROLE_KEY": "aura_sk_…"
}
}
}
}
En una pila Docker/k3d local, establezca AURABASE_URL en http://localhost:8080.
Modo HTTP (servidor local)
Inicie el servidor HTTP local (ver arriba), luego agregue su URL y el valor --auth-token como token de portador.
Cursor: .cursor/mcp.json o ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Windsurf - ~/.codeium/windsurf/mcp_config.json (la clave es serverUrl):
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Continuar.dev (Código VS y JetBrains con Codestral) — ~/.continue/config.yaml:
models:
- name: Codestral
provider: mistral
model: codestral-latest
apiKey: MISTRAL_API_KEY
mcpServers:
- name: aurabase
url: http://127.0.0.1:3001/mcp
headers:
Authorization: Bearer my_secret_token
Mistral AI (Agents & Connectors) llega a los servidores MCP a través de una URL HTTPS pública: utilizará el servicio alojado (https://mcp.aurabase.dev/mcp), planificado, aún no activo.
Una herramienta devuelve la respuesta del backend o un error#
Nunca un valor fabricado. Esta regla no es una intención: es verificada en cada ejecución del CI por un banco que lanza el servidor contra una URL inactiva y falla si la más mínima herramienta responde con éxito. Cada herramienta también declara un esquema de salida que el SDK valida antes de emitir la respuesta.
El modo de solo lectura (--read-only) elimina las herramientas mutantes del catálogo y indica a PostgreSQL que ejecute SQL en una transacción de solo lectura (37 herramientas de 86): la garantía proviene del motor, no solo del filtrado del lado del cliente.
Banderas y variables de entorno.#
--url(AURABASE_URL) — Aurabase URL de instancia--project-id(AURABASE_PROJECT_ID) — ID del proyecto--service-role-key(AURABASE_SERVICE_ROLE_KEY) — Clave de administrador--read-only(AURABASE_READ_ONLY) — Solo expone herramientas de lectura (37 de 86)--allowed-tools(AURABASE_ALLOWED_TOOLS) — Lista blanca, separada por comas--destructive-policy(MCP_DESTRUCTIVE_POLICY) — Confirmación interactiva de operaciones SQL destructivas:elicit(predeterminado),token,deny--state-key(MCP_STATE_KEY) — Clave (≥ 32 bytes) que firma confirmaciones multiturno--transport—stdio(predeterminado) ohttp--port— Puerto de transporte HTTP (predeterminado 3001)--host— Interfaz de escucha HTTP (predeterminada127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — Se requiere token en /mcp; se requiere en modo http
Distribuido por dominio#
82 expuestos con una clave de proyecto simple, 4 reservados para el plan de gestión (claves API y list_all_projects; mejor ninguna herramienta que una herramienta que falla sistemáticamente sin este canal).
| Base de datos (23) | list_tables, describe_table, get_rendimiento_advisors, list_extensions, ejecutar_sql, query_table, insert_rows, update_rows, eliminar_rows, call_rpc, generate_types, diff_schema, apply_migration, list_migrations, explicar_query, analice_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, crear_sql_trigger, soltar_sql_trigger |
|---|---|
| Almacenamiento (9) | list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, vacio_bucket |
| Autenticación (7) | listar_usuarios, obtener_usuario, crear_usuario, actualizar_usuario, eliminar_usuario, banear_usuario, generar_enlace |
| Notificaciones (10) | send_email, send_push_notification, send_sms, list_notification_logs, get_notification_settings, update_notification_settings, list_notification_templates, create_notification_template, delete_notification_template, get_notification_stats |
| Copias de seguridad (5) | list_backups, crear_copia de seguridad, restaurar_copia de seguridad, get_backup_schedule, set_backup_schedule |
| Edge Functions (6) | invocar_función, listar_funciones, obtener_función_info, implementar_función, eliminar_función, establecer_función_env |
| RLS (6) | list_rls_policies, create_rls_policy, update_rls_policy, drop_rls_policy, toggle_rls, get_security_advisors |
| IA (5) | index_document, rag_query, vector_search, create_vector_index, ai_completion |
| Observabilidad (4) | get_project_metrics, list_slow_queries, list_active_queries, cancel_query |
| Tiempo real (3) | list_realtime_channels, get_realtime_settings, update_realtime_settings |
| Proyecto (4) | project_info, switch_project, get_active_project, list_all_projects (canal de gestión) |
| Claves API (3) | create_api_key, list_api_keys, revoke_api_key (canal de gestión) |
| Documentación (1) | search_docs — buscar en documentación integrada (inglés) |
Las herramientas *_sql_function / *_sql_trigger crean funciones y activadores PostgreSQL reales almacenados en el esquema del proyecto, sin relación con list_functions / deploy_function (Edge Functions WASM, un tiempo de ejecución separado).
Modo HTTP para clientes que se conectan por URL#
stdio es el transporte predeterminado. El modo http (HTTP transmitible, protocolos MCP 2025-11-25 y 2026-07-28):
- escucha en
127.0.0.1de forma predeterminada (--hostpara cambiarlo); - requiere un token (
--auth-tokeno token de portador); sin él, el servidor se niega a iniciarse; - valida el encabezado
Originy responde 403 a un origen no autorizado (protección anti-CSRF); - una instancia de servidor por sesión, con vencimiento y límite configurable;
- compara tokens en tiempo constante y limita el tamaño del cuerpo de la solicitud.