Przejdź do treści
Logo Aurabase
aurabaza

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.

Referencja7 min przeczytanePoziom odniesienieZmieniono 18 paź 2026

Źródło angielskie uległo zmianie od czasu tego tłumaczenia. Niektóre informacje mogą być nieaktualne.
Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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:

  1. tryb stdio (domyślny): Twój klient MCP uruchamia serwer jako podproces z npx.
  2. 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.

terminalbash
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:

terminalbash
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:

mcp_config.jsonjson
{
  "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:

.cursor/mcp.jsonjson
{
  "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):

mcp_config.jsonjson
{
  "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:

config.yamlyaml
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.

Wskazówka

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) lub http
  • --port — port transportowy HTTP (domyślnie 3001)
  • --host — interfejs nasłuchiwania HTTP (domyślny 127.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 (--host aby to zmienić);
  • wymaga tokena (--auth-token lub Bearer token) — bez niego serwer odmawia startu;
  • sprawdza nagłówek Origin i 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.

Aby pójść dalej#