Serwer MCP
Kontroluj swój backend Aurabase z Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code lub dowolnego klienta kompatybilnego z Model Context Protocol — 86 narzędzi, bez wartości fabrycznej.
Domyślnie lokalny tryb stdio, lokalny tryb HTTP#
Oficjalny serwer Aurabase MCP udostępnia 86 narzędzi do sprawdzania i kontrolowania backendu (82 z kluczem projektu). Działa na Twoim komputerze w jednym z dwóch trybów:
- tryb stdio (domyślny): Twój klient MCP uruchamia serwer jako podproces z
npx. - Tryb HTTP (Streamable HTTP): uruchamiasz jeden lokalny serwer (
http://127.0.0.1:3001/mcp) i wskazujesz każdemu klientowi jego adres URL.
Usługa hostowana (https://mcp.aurabase.dev/mcp, zaloguj się za pomocą OAuth 2.1) jest planowana, ale jeszcze nie dostępna.
Pakiet zawiera dwa pliki binarne (aurabase-mcp i aurabase-mcp-hosted), więc npx potrzebuje nazwy binarnej: npx -y -p @aurabase/mcp-server aurabase-mcp. Wymagany jest --project-id.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
Aby zamiast tego uruchomić lokalny serwer HTTP, dodaj transport, port i 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_…
Konfiguracja według klienta i trybu#
tryb stdio (domyślny)
Kursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) i VS Code z kodem Cline lub Roo (cline_mcp_settings.json) używają tego samego bloku:
{
"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_…"
}
}
}
}
W stosunku do lokalnego stosu Docker/k3d ustaw AURABASE_URL na http://localhost:8080.
Tryb HTTP (serwer lokalny)
Uruchom lokalny serwer HTTP (patrz wyżej), następnie dodaj jego adres URL i wartość --auth-token jako token nośnika.
Kursor — .cursor/mcp.json lub ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Windsurfing — ~/.codeium/windsurf/mcp_config.json (klucz to serverUrl):
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Kontynuuj.dev (VS Code i JetBrains z 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 (Agenci i łączniki) dociera do serwerów MCP za pośrednictwem publicznego adresu URL HTTPS: będzie korzystać z usługi hostowanej (https://mcp.aurabase.dev/mcp), planowanej, jeszcze nie uruchomionej.
Narzędzie zwraca odpowiedź z backendu lub błąd#
Nigdy wartość produkcyjna. Zasada ta nie jest zamierzona: jest sprawdzana przy każdym wykonaniu CI przez stanowisko testowe, które uruchamia serwer pod martwym adresem URL i kończy się niepowodzeniem, jeśli najmniejsze narzędzie pomyślnie odpowie. Każde narzędzie deklaruje również schemat wyjściowy, który sprawdza zestaw SDK przed wyemitowaniem odpowiedzi.
Tryb tylko do odczytu (--read-only) usuwa narzędzia mutujące z katalogu i instruuje PostgreSQL wykonanie kodu SQL w transakcji tylko do odczytu (37 narzędzi z 86) — gwarancja pochodzi z silnika, a nie tylko z filtrowania po stronie klienta.
Flagi i zmienne środowiskowe#
--url(AURABASE_URL) — Aurabase URL instancji--project-id(AURABASE_PROJECT_ID) — Identyfikator projektu--service-role-key(AURABASE_SERVICE_ROLE_KEY) — Klucz administratora--read-only(AURABASE_READ_ONLY) — Wyświetla tylko narzędzia do czytania (37 z 86)--allowed-tools(AURABASE_ALLOWED_TOOLS) — Biała lista oddzielona przecinkami--destructive-policy(MCP_DESTRUCTIVE_POLICY) — Interaktywne potwierdzenie destrukcyjnych operacji SQL:elicit(domyślnie),token,deny--state-key(MCP_STATE_KEY) — Klucz (≥ 32 bajty) podpisujący potwierdzenia wieloobrotowe--transport—stdio(domyślnie) lubhttp--port— port transportowy HTTP (domyślnie 3001)--host— interfejs nasłuchiwania HTTP (domyślny127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — Wymagany token na /mcp — wymagany w trybie http
Dystrybucja według domeny#
82 eksponowane za pomocą prostego klucza projektu, 4 zarezerwowane dla planu zarządzania (klucze API i list_all_projects — lepsze żadne narzędzie niż narzędzie, które systematycznie zawodzi bez tego kanału).
| Baza danych (23) | list_tables, opisz_table, get_ Performance_advisors, list_extensions, wykonaj_sql, query_table, wstaw_rows, update_rows, usuń_rows, call_rpc, generate_types, diff_schema, Apply_migration, list_migrations, wyjaśnij_query, analiz_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger |
|---|---|
| Przechowywanie (9) | list_buckets, get_bucket, create_bucket, list_files, Delete_files, move_file, create_signed_url, upload_file, pusty_bucket |
| Autoryzacja (7) | lista_użytkowników, get_user, tworzenie_użytkownika, aktualizacja_użytkownika, usuwanie_użytkownika, ban_użytkownika, generowanie_linku |
| Powiadomienia (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 |
| Kopie zapasowe (5) | list_backups, utwórz_kopię zapasową, przywróć_kopię zapasową, get_backup_schedule, set_backup_schedule |
| Edge Functions (6) | wywołanie_funkcji, lista_funkcji, get_function_info, wdrożenie_funkcji, usunięcie_funkcji, set_function_env |
| RLS (6) | list_rls_policies, create_rls_policy, update_rls_policy, drop_rls_policy, toggle_rls, get_security_advisors |
| Sztuczna inteligencja (5) | dokument_indeksowy, rag_query, wyszukiwanie_wektorowe, tworzenie_indeksu_wektorowego, ukończenie_ai |
| Obserwowalność (4) | get_project_metrics, list_slow_queries, list_active_queries, cancel_query |
| Czas rzeczywisty (3) | list_realtime_channels, get_realtime_settings, update_realtime_settings |
| Projekt (4) | Project_info, switch_project, get_active_project, list_all_projects (kanał zarządzania) |
| Klucze API (3) | create_api_key, list_api_keys, revoke_api_key (kanał zarządzania) |
| Dokumentacja (1) | search_docs — wyszukiwanie w osadzonej dokumentacji (angielski) |
Narzędzia *_sql_function / *_sql_trigger tworzą rzeczywiste funkcje i wyzwalacze PostgreSQL przechowywane w schemacie projektu — niezwiązane z list_functions / deploy_function (Edge Functions WASM, oddzielne środowisko wykonawcze).
Tryb HTTP dla klientów łączących się za pomocą adresu URL#
stdio jest transportem domyślnym. Tryb http (protokoły Streamable HTTP, MCP 2025-11-25 i 2026-07-28):
- domyślnie nasłuchuje na
127.0.0.1(--hostaby to zmienić); - wymaga tokena (
--auth-tokenlub Bearer token) — bez niego serwer odmawia startu; - sprawdza nagłówek
Origini odpowiada 403 na nieautoryzowane pochodzenie (ochrona anty-CSRF); - jedna instancja serwera na sesję, z wygaśnięciem i konfigurowalnym limitem;
- porównuje tokeny w stałym czasie i ogranicza rozmiar treści żądania.