MCP サーバー
Claude Desktop、Cursor、Windsurf、Antigravity、Mistral AI、VS Code、または任意の Model Context Protocol 互換クライアントから Aurabase バックエンドを制御します。86 ツール、製造値なし。
デフォルトではローカル stdio モード、ローカル HTTP モード#
公式 Aurabase MCP サーバーは、バックエンド (プロジェクト キーを含む 82) を検査および制御するための 86 ツール を公開します。次の 2 つのモードのいずれかでマシン上で実行されます。
- stdio モード (デフォルト): MCP クライアントは、
npxのサブプロセスとしてサーバーを起動します。 - HTTP モード (ストリーミング可能な HTTP): 1 つのローカル サーバー (
http://127.0.0.1:3001/mcp) を起動し、各クライアントにその URL を指定します。
ホストされたサービス (https://mcp.aurabase.dev/mcp、 OAuth 2.1 でサインイン) は計画されていますが、まだ公開されていません。
パッケージには 2 つのバイナリ (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_…
クライアントごとおよびモードごとの構成#
標準出力モード (デフォルト)
カーソル (.cursor/mcp.json)、Claude Desktop (claude_desktop_config.json)、Windsurf (~/.codeium/windsurf/mcp_config.json)、Google Antigravity (~/.gemini/config/mcp_config.json)、および Cline または Roo コードを使用した VS Code (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 with 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) を使用しますが、計画されており、まだ稼働していません。
ツールがバックエンドから応答を返すか、エラーを返します。#
決して製造された価値ではありません。このルールは意図的なものではありません。このルールは、無効な URL に対してサーバーを起動するベンチによって CI の実行ごとにチェックされ、わずかなツールが正常に応答した場合は失敗します。各ツールは、応答を出力する前に SDK が検証する出力スキーマも宣言します。
読み取り専用モード (--read-only) は、カタログから変更ツールを削除します。 および は、読み取り専用トランザクション (86 個中 37 個のツール) で SQL を実行するように PostgreSQL に指示します。この保証は、クライアント側のフィルター処理だけでなく、エンジンからもたらされます。
フラグと環境変数#
--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、create_sql_trigger、drop_sql_trigger |
|---|---|
| ストレージ (9) | list_buckets、get_bucket、create_bucket、list_files、delete_files、move_file、create_signed_url、upload_file、empty_bucket |
| 認証 (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) | 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 |
| AI(5) | Index_document、rag_query、vector_search、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 ツールは、 list_functions / deploy_function (Edge Functions WASM、別個のランタイム) とは関係なく、プロジェクト スキーマに保存される実際の PostgreSQL 関数とトリガーを作成します。
URL で接続するクライアントの HTTP モード#
stdio はデフォルトのトランスポートです。 http モード (ストリーミング可能な HTTP、MCP プロトコル 2025-11-25 および 2026-07-28):
- デフォルトで
127.0.0.1をリッスンします (変更するには--host)。 - トークン (
--auth-tokenまたはベアラー トークン) が必要です。トークンがないと、サーバーは起動を拒否します。 Originヘッダーを検証し、未承認の発信元に 403 で応答します (CSRF 対策保護)。- セッションごとに 1 つのサーバー インスタンス。有効期限と設定可能な上限あり。
- トークンを一定時間で比較し、リクエスト本体のサイズを制限します。