MCP Сервер
Управляйте своим бэкэндом Aurabase с помощью Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code или любого клиента, совместимого с Model Context Protocol — 86 инструментов, без производственной ценности.
Локальный режим stdio по умолчанию, локальный режим HTTP#
Официальный сервер Aurabase MCP предоставляет 86 инструментов для проверки и управления вашим сервером (82 с ключом проекта). Он запускается на вашем компьютере в одном из двух режимов:
- режим stdio (по умолчанию): ваш клиент MCP запускает сервер как подпроцесс с
npx. - Режим 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.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
Чтобы вместо этого запустить локальный HTTP-сервер, добавьте транспорт, порт и токен:
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) используют один и тот же блок:
{
"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:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Виндсерфинг — ~/.codeium/windsurf/mcp_config.json (ключ serverUrl):
{
"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:
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); - один экземпляр сервера на сеанс со сроком действия и настраиваемым ограничением;
- сравнивает токены за постоянное время и ограничивает размер тела запроса.