跳到内容
光环标志
光环基地

MCP 服务器

从 Claude Desktop、Cursor、Windsurf、Antigravity、Mistral AI、VS Code 或任何模型上下文协议兼容客户端控制您的 Aurabase 后端 — 86 种工具,无制造价值。

参考7分钟 读取级别 参考修改于 2026年10月18日

自此翻译以来,英文来源已发生变化。某些信息可能已过时。
该页面已自动翻译。英文版具有权威性。

默认本地stdio模式,本地HTTP模式#

官方 Aurabase MCP 服务器公开 86 个工具 来检查和控制您的后端(82 个带有项目密钥)。它以两种模式之一在您的计算机上运行:

  1. stdio 模式(默认):您的 MCP 客户端使用 npx将服务器作为子进程启动。
  2. HTTP 模式(流式 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) 和带有 Cline 或 Roo Code (cline_mcp_settings.json) 的 VS Code 使用相同的块:

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(代理和连接器)通过公共 HTTPS URL 到达 MCP 服务器:它将使用托管服务 (https://mcp.aurabase.dev/mcp),已计划,尚未上线。

工具返回后端的响应,或者错误#

从来都不是制造出来的价值。此规则并非有意为之:每次执行 CI 时都会由一个工作台进行检查,该工作台针对死 URL 启动服务器,如果最轻微的工具成功响应,则该规则会失败。每个工具还声明一个输出架构,SDK 在发出响应之前验证该架构。

提示

只读模式 (--read-only) 从目录中删除变异工具,并指示 PostgreSQL 在只读事务中执行 SQL(86 个工具中的 37 个)——保证来自引擎,而不仅仅是来自客户端过滤。

标志和环境变量#

  • --url (AURABASE_URL) — Aurabase 实例 URL
  • --project-id (AURABASE_PROJECT_ID) — 项目 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、describe_table、get_performance_advisors、list_extensions、execute_sql、query_table、insert_rows、update_rows、delete_rows、call_rpc、generate_types、diff_schema、apply_migration、list_migrations、explain_query、analyze_table、get_db_size、list_sql_functions、create_sql_function、drop_sql_function、list_sql_triggers、创建_sql_trigger、删除_sql_trigger
存储 (9)list_buckets、get_bucket、create_bucket、list_files、delete_files、move_file、create_signed_url、upload_file、empty_bucket
授权 (7)列表用户、获取用户、创建用户、更新用户、删除用户、禁止用户、生成链接
通知 (10)发送电子邮件、发送推送通知、发送短信、列表通知日志、获取通知设置、更新通知设置、列表通知模板、创建通知模板、删除通知模板、获取通知统计
备份 (5)列表备份、创建备份、恢复备份、获取备份计划、设置备份计划
Edge Functions (6)invoke_function、list_functions、get_function_info、deploy_function、delete_function、set_function_env
RLS (6)list_rls_policies、create_rls_policy、update_rls_policy、drop_rls_policy、toggle_rls、get_security_advisors
人工智能 (5)索引文档、rag_query、向量搜索、创建向量索引、ai_completion
可观测性 (4)get_project_metrics、list_slow_queries、list_active_queries、cancel_query
实时 (3)列表实时频道、获取实时设置、更新实时设置
项目 (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,单独的运行时)无关。

通过 URL 连接的客户端的 HTTP 模式#

stdio 是默认传输。 http 模式(流式 HTTP、MCP 协议 2025-11-25 和 2026-07-28):

  • 默认监听 127.0.0.1 (--host 来更改它);
  • 需要一个令牌(--auth-token 或 Bearer 令牌)——没有它,服务器将拒绝启动;
  • 验证 Origin 标头并对未经授权的来源响应 403(反 CSRF 保护);
  • 每个会话一个服务器实例,具有过期时间和可配置的上限;
  • 在恒定时间内比较令牌并限制请求正文大小。

为了走得更远#