Serveur MCP
Contrôlez votre backend Aurabase depuis Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code ou tout client compatible Model Context Protocol — 86 outils, aucune valeur manufacturée.
Mode stdio local par défaut, mode HTTP local#
Le serveur officiel Aurabase MCP expose 86 outils pour inspecter et contrôler votre backend (82 avec une clé de projet). Il s'exécute sur votre ordinateur, dans l'un des deux modes suivants :
- mode stdio (par défaut): votre client MCP démarre le serveur en tant que sous-processus avec
npx. - Mode HTTP (Streamable HTTP): vous démarrez un serveur local (
http://127.0.0.1:3001/mcp) et pointez chaque client vers son URL.
Le service hébergé (https://mcp.aurabase.dev/mcp, connexion avec OAuth 2.1) est prévu, pas encore disponible.
Le package contient deux binaires (aurabase-mcp et aurabase-mcp-hosted), donc npx a besoin du nom binaire : npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id est requis.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
Pour démarrer le serveur HTTP local, ajoutez le transport, le port et le jeton :
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_…
Configuration par client et par mode#
mode stdio (par défaut)
Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) et VS Code avec Cline ou Roo Code (cline_mcp_settings.json) utilisent le même bloc :
{
"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_…"
}
}
}
}
Sur une pile Docker/k3d locale, définissez AURABASE_URL sur http://localhost:8080.
Mode HTTP (serveur local)
Démarrez le serveur HTTP local (voir ci-dessus), puis ajoutez son URL et la valeur --auth-token en tant que jeton Bearer.
Curseur — .cursor/mcp.json ou ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Planche à voile — ~/.codeium/windsurf/mcp_config.json (la clé est serverUrl) :
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Continue.dev (VS Code & JetBrains avec 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 & Connecteurs) atteint les serveurs MCP via une URL HTTPS publique : il utilisera le service hébergé (https://mcp.aurabase.dev/mcp), prévu, pas encore opérationnel.
Un outil renvoie la réponse du backend, ou une erreur#
Jamais une valeur fabriquée. Cette règle n'est pas une intention : elle est vérifiée à chaque exécution du CI par un banc qui lance le serveur contre une URL morte et échoue si le moindre outil répond avec succès. Chaque outil déclare également un schéma de sortie que le SDK valide avant d'émettre la réponse.
Le mode lecture seule (--read-only) supprime les outils de mutation du catalogue et demande à PostgreSQL d'exécuter le SQL dans une transaction en lecture seule (37 outils sur 86) — la garantie vient du moteur, pas seulement du filtrage côté client.
Indicateurs et variables d'environnement#
--url(AURABASE_URL) — Aurabase URL de l'instance--project-id(AURABASE_PROJECT_ID) — ID du projet--service-role-key(AURABASE_SERVICE_ROLE_KEY) — Clé d'administration--read-only(AURABASE_READ_ONLY) — Expose uniquement les outils de lecture (37 sur 86)--allowed-tools(AURABASE_ALLOWED_TOOLS) — Liste blanche, séparée par des virgules--destructive-policy(MCP_DESTRUCTIVE_POLICY) — Confirmation interactive des opérations SQL destructives :elicit(par défaut),token,deny--state-key(MCP_STATE_KEY) — Clé (≥ 32 octets) qui signe les confirmations multitours--transport—stdio(par défaut) ouhttp--port— Port de transport HTTP (3001 par défaut)--host— Interface d'écoute HTTP (par défaut127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — Jeton requis sur /mcp — requis en mode http
Distribué par domaine#
82 exposés avec une simple clé de projet, 4 réservés au plan de gestion (clés API et list_all_projects — mieux vaut pas d'outil qu'un outil qui échoue systématiquement sans ce canal).
| Base de données (23) | list_tables, décrire_table, get_performance_advisors, list_extensions, exécuter_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, generate_types, diff_schema, apply_migration, list_migrations, expliquer_query, analyser_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger |
|---|---|
| Stockage (9) | list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket |
| Authentification (7) | list_users, get_user, create_user, update_user, delete_user, ban_user, generate_link |
| Notifications (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 |
| Sauvegardes (5) | list_backups, create_backup, restaurer_backup, get_backup_schedule, set_backup_schedule |
| Edge Functions (6) | Invoquer_fonction, list_fonctions, get_function_info, déployer_fonction, delete_function, set_function_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 |
| Observabilité (4) | get_project_metrics, list_slow_queries, list_active_queries, Cancel_query |
| Temps réel (3) | list_realtime_channels, get_realtime_settings, update_realtime_settings |
| Projet (4) | project_info, switch_project, get_active_project, list_all_projects (canal de gestion) |
| Clés API (3) | create_api_key, list_api_keys, revoke_api_key (canal de gestion) |
| Documents (1) | search_docs — recherche dans la documentation intégrée (anglais) |
Les outils *_sql_function / *_sql_trigger créent de véritables fonctions et déclencheurs PostgreSQL stockés dans le schéma du projet - sans rapport avec list_functions / deploy_function (Edge Functions WASM, un runtime distinct).
Mode HTTP pour les clients qui se connectent par URL#
stdio est le transport par défaut. Le mode http (Streamable HTTP, protocoles MCP 2025-11-25 et 2026-07-28) :
- écoute sur
127.0.0.1par défaut (--hostpour le changer) ; - nécessite un jeton (
--auth-tokenou jeton Bearer) — sans lui, le serveur refuse de démarrer ; - valide l'entête
Originet répond 403 à une origine non autorisée (protection anti-CSRF) ; - une instance de serveur par session, avec expiration et plafond configurable ;
- compare les jetons en temps constant et limite la taille du corps de la demande.