Перейти к содержимому
Логотип Аурабаза
аурабаза

MCP Сервер

Управляйте своим бэкэндом Aurabase с помощью Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code или любого клиента, совместимого с Model Context Protocol — 86 инструментов, без производственной ценности.

Справочник7 мин читатьУровень ссылкаПересмотрено 18 окт. 2026 г.

Английский источник изменился после этого перевода. Некоторая информация может быть устаревшей.
Эта страница была переведена автоматически. Английская версия является авторитетной.

Локальный режим stdio по умолчанию, локальный режим HTTP#

Официальный сервер Aurabase MCP предоставляет 86 инструментов для проверки и управления вашим сервером (82 с ключом проекта). Он запускается на вашем компьютере в одном из двух режимов:

  1. режим stdio (по умолчанию): ваш клиент MCP запускает сервер как подпроцесс с npx.
  2. Режим HTTP (Streamable HTTP): вы запускаете один локальный сервер (http://127.0.0.1:3001/mcp) и указываете каждому клиенту его URL-адрес.

Размещенная служба (https://mcp.aurabase.dev/mcp, вход с помощью OAuth 2.1) запланирована, но еще не запущена.

В пакете есть два двоичных файла (aurabase-mcp и aurabase-mcp-hosted), поэтому npx необходимо двоичное имя: npx -y -p @aurabase/mcp-server aurabase-mcp. Требуется --project-id.

terminalbash
npx -y -p @aurabase/mcp-server aurabase-mcp \
  --url https://<slug>.aurabase.cloud \
  --project-id <uuid> \
  --service-role-key aura_sk_…

Чтобы вместо этого запустить локальный HTTP-сервер, добавьте транспорт, порт и токен:

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_…

Конфигурация для каждого клиента и режима#

режим stdio (по умолчанию)

Курсор (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) и VS Code с кодом Cline или Roo (cline_mcp_settings.json) используют один и тот же блок:

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_…"
      }
    }
  }
}

В локальном стеке Docker/k3d установите для AURABASE_URL значение http://localhost:8080.

Режим HTTP (локальный сервер)

Запустите локальный HTTP-сервер (см. выше), затем добавьте его URL-адрес и значение --auth-token в качестве токена носителя.

Курсор — .cursor/mcp.json или ~/.cursor/mcp.json:

.cursor/mcp.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "url": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

Виндсерфинг — ~/.codeium/windsurf/mcp_config.json (ключ serverUrl):

mcp_config.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "serverUrl": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

Continue.dev (VS Code и JetBrains с 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 (агенты и соединители) достигает серверов MCP по общедоступному URL-адресу HTTPS: он будет использовать размещенную службу (https://mcp.aurabase.dev/mcp), запланированную, но еще не запущенную.

Инструмент возвращает ответ от серверной части или ошибку.#

Никогда не являлась искусственной ценностью. Это правило не является намерением: оно проверяется при каждом выполнении CI стендом, который запускает сервер по неработающему URL-адресу и дает сбой, если малейший инструмент отвечает успешно. Каждый инструмент также объявляет схему вывода, которую SDK проверяет перед отправкой ответа.

Совет

Режим только для чтения (--read-only) удаляет мутирующие инструменты из каталога , а инструктирует PostgreSQL выполнять SQL в транзакции только для чтения (37 инструментов из 86) — гарантия исходит от движка, а не только от фильтрации на стороне клиента.

Флаги и переменные среды#

  • --url (AURABASE_URL) — Aurabase URL-адрес экземпляра
  • --project-id (AURABASE_PROJECT_ID) — Идентификатор проекта
  • --service-role-key (AURABASE_SERVICE_ROLE_KEY) — Ключ администратора
  • --read-only (AURABASE_READ_ONLY) — Предоставляет только инструменты чтения (37 из 86)
  • --allowed-tools (AURABASE_ALLOWED_TOOLS) — Белый список, через запятую
  • --destructive-policy (MCP_DESTRUCTIVE_POLICY) — Интерактивное подтверждение деструктивных операций SQL: elicit (по умолчанию), token, deny
  • --state-key (MCP_STATE_KEY) — Ключ (≥ 32 байт), который подписывает многооборотные подтверждения
  • --transport — stdio (по умолчанию) или http
  • --port — Транспортный порт HTTP (по умолчанию 3001)
  • --host — интерфейс прослушивания HTTP (по умолчанию 127.0.0.1)
  • --auth-token (AURABASE_MCP_AUTH_TOKEN) — Токен требуется в /mcp — требуется в режиме http

Распределено по домену#

82 доступны с помощью простого ключа проекта, 4 зарезервированы для плана управления (ключи API и list_all_projects — лучше никакого инструмента, чем инструмент, который систематически выходит из строя без этого канала).

База данных (23)list_tables, описать_таблицу, get_ Performance_advisors, list_extensions, выполнить_sql, запрос_таблицу, вставить_строки, обновить_строки, удалить_строки, вызов_rpc, генерировать_типы, diff_schema, apply_migration, list_migrations, объяснять_запрос, анализировать_таблицу, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger
Хранение (9)list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, пустой_бакет
Аутентификация (7)list_users, get_user, create_user, update_user, delete_user, Ban_user,generate_link
Уведомления (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
Резервные копии (5)list_backups, create_backup,restore_backup, get_backup_schedule, set_backup_schedule
Edge Functions (6)вызов_функции, список_функций, get_function_info, развертывание_функции, удаление_функции, set_function_env
RLS (6)list_rls_policy, create_rls_policy, update_rls_policy, drop_rls_policy, toggle_rls, get_security_advisors
ИИ (5)index_document, rag_query, вектор_поиск, create_vector_index, ai_completion
Наблюдаемость (4)get_project_metrics, list_slow_queries, list_active_queries, cancel_query
В реальном времени (3)list_realtime_channels, get_realtime_settings, update_realtime_settings
Проект (4)project_info, switch_project, get_active_project, list_all_projects (канал управления)
API-ключи (3)create_api_key, list_api_keys, revoke_api_key (канал управления)
Документация (1)search_docs — поиск во встроенной документации (англ.)

Инструменты *_sql_function / *_sql_trigger создают реальные функции и триггеры PostgreSQL, хранящиеся в схеме проекта — не связанные с list_functions / deploy_function (Edge Functions WASM, отдельная среда выполнения).

Режим HTTP для клиентов, подключающихся по URL-адресу#

stdio — транспорт по умолчанию. Режим http (Streamable HTTP, протоколы MCP 2025-11-25 и 2026-07-28):

  • по умолчанию прослушивает 127.0.0.1 (--host, чтобы изменить его);
  • требует токен (--auth-token или Bearer token) — без него сервер отказывается запускаться;
  • проверяет заголовок Origin и отвечает 403 на неавторизованное происхождение (защита от CSRF);
  • один экземпляр сервера на сеанс со сроком действия и настраиваемым ограничением;
  • сравнивает токены за постоянное время и ограничивает размер тела запроса.

Чтобы пойти дальше#