MCP 服务器
从 Claude Desktop、Cursor、Windsurf、Antigravity、Mistral AI、VS Code 或任何模型上下文协议兼容客户端控制您的 Aurabase 后端 — 86 种工具,无制造价值。
默认本地stdio模式,本地HTTP模式#
官方 Aurabase MCP 服务器公开 86 个工具 来检查和控制您的后端(82 个带有项目密钥)。它以两种模式之一在您的计算机上运行:
- stdio 模式(默认):您的 MCP 客户端使用
npx将服务器作为子进程启动。 - 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 是必需的。
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) 和带有 Cline 或 Roo Code (cline_mcp_settings.json) 的 VS Code 使用相同的块:
{
"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(代理和连接器)通过公共 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 保护); - 每个会话一个服务器实例,具有过期时间和可配置的上限;
- 在恒定时间内比较令牌并限制请求正文大小。