MCP Sunucu
Aurabase arka ucunuzu Claude Desktop, Cursor, Windsurf, Antigravity, Mistral AI, VS Code veya herhangi bir Model Bağlam Protokolü uyumlu istemciden kontrol edin — 86 araç, üretilmiş değer yok.
Varsayılan olarak yerel stdio modu, yerel HTTP modu#
Resmi Aurabase MCP sunucusu, arka ucunuzu incelemek ve kontrol etmek için 86 aracı kullanıma sunar (proje anahtarıyla 82 araç). Makinenizde iki moddan birinde çalışır:
- stdio modu (varsayılan): MCP istemciniz sunucuyu
npxile bir alt işlem olarak başlatır. - HTTP modu (Akışlı HTTP): bir yerel sunucuyu (
http://127.0.0.1:3001/mcp) başlatırsınız ve her istemciyi kendi URL'sine yönlendirirsiniz.
Barındırılan hizmet (https://mcp.aurabase.dev/mcp, OAuth 2.1 ile oturum açma) planlanmıştır, henüz yayınlanmamıştır.
Paketin iki ikili dosyası vardır (aurabase-mcp ve aurabase-mcp-hosted), dolayısıyla npx ikili adına ihtiyaç duyar: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id gereklidir.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
Bunun yerine yerel HTTP sunucusunu başlatmak için aktarımı, bağlantı noktasını ve belirteci ekleyin:
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_…
İstemci ve mod başına yapılandırma#
stdio modu (varsayılan)
İmleç (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Google Antigravity (~/.gemini/config/mcp_config.json) ve Cline veya Roo Kodlu VS Kodu (cline_mcp_settings.json) aynı bloğu kullanır:
{
"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_…"
}
}
}
}
Yerel bir Docker/k3d yığınına karşı AURABASE_URL öğesini http://localhost:8080 olarak ayarlayın.
HTTP modu (yerel sunucu)
Yerel HTTP sunucusunu başlatın (yukarı bakın), ardından URL'sini ve --auth-token değerini Taşıyıcı belirteci olarak ekleyin.
İmleç — .cursor/mcp.json veya ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Rüzgar Sörfü — ~/.codeium/windsurf/mcp_config.json (anahtar serverUrl):
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
Continue.dev (Codestral ile VS Code ve JetBrains) — ~/.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 (Aracılar ve Bağlayıcılar), genel bir HTTPS URL'si üzerinden MCP sunucularına ulaşır: planlanan, henüz yayınlanmayan barındırılan hizmeti (https://mcp.aurabase.dev/mcp) kullanır.
Bir araç, arka uçtan gelen yanıtı veya bir hatayı döndürür#
Asla üretilmiş bir değer değildir. Bu kural bir amaç değildir: CI'nin her yürütülmesinde, sunucuyu ölü bir URL'ye karşı başlatan ve en ufak bir aracın başarıyla yanıt vermesi durumunda başarısız olan bir tezgah tarafından kontrol edilir. Her araç ayrıca SDK'nın yanıtı göndermeden önce doğruladığı bir çıkış şeması da bildirir.
Salt okunur mod (--read-only), mutasyona uğrayan araçları kataloğundan kaldırır ve, PostgreSQL'ye SQL'i salt okunur bir işlemde yürütmesi talimatını verir (37 araç / 86) — garanti yalnızca istemci tarafı filtrelemeden değil, motordan gelir.
Bayraklar ve ortam değişkenleri#
--url(AURABASE_URL) — Aurabase örnek URL'si--project-id(AURABASE_PROJECT_ID) — Proje Kimliği--service-role-key(AURABASE_SERVICE_ROLE_KEY) — Yönetici Anahtarı--read-only(AURABASE_READ_ONLY) — Yalnızca okuma araçlarını gösterir (37 / 86)--allowed-tools(AURABASE_ALLOWED_TOOLS) — Beyaz liste, virgülle ayrılmış--destructive-policy(MCP_DESTRUCTIVE_POLICY) — Yıkıcı SQL işlemlerinin etkileşimli onayı:elicit(varsayılan),token,deny--state-key(MCP_STATE_KEY) — Çok dönüşlü onayları imzalayan anahtar (≥ 32 bayt)--transport—stdio(varsayılan) veyahttp--port— HTTP aktarım bağlantı noktası (varsayılan 3001)--host— HTTP dinleme arayüzü (varsayılan127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — /mcp üzerinde jeton gerekli — http modunda gerekli
Etki alanına göre dağıtılır#
82'si basit bir proje anahtarıyla açığa çıkarıldı, 4'ü yönetim planı için ayrıldı (API anahtarları ve list_all_projects - bu kanal olmadan sistematik olarak başarısız olan bir araçtansa hiç araç olmaması daha iyidir).
| Veritabanı (23) | list_tables, define_table, get_performans_advisors, list_extensions, executive_sql, query_table, insert_rows, update_rows, delete_rows, call_rpc, created_types, diff_schema, application_migration, list_migrations, açıkla_query, analyze_table, get_db_size, list_sql_functions, create_sql_function, drop_sql_function, list_sql_triggers, create_sql_trigger, drop_sql_trigger |
|---|---|
| Depolama (9) | list_buckets, get_bucket, create_bucket, list_files, delete_files, move_file, create_signed_url, upload_file, empty_bucket |
| Yetkilendirme (7) | list_users, get_user, create_user, update_user, delete_user, ban_user, created_link |
| Bildirimler (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 |
| Yedeklemeler (5) | list_backups, create_backup, restore_backup, get_backup_schedule, set_backup_schedule |
| Edge Functions (6) | çağırma_işlevi, liste_işlevleri, get_işlev_bilgisi, konuşlandırma_işlevi, silme_işlevi, set_işlev_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, vektör_arama, create_vector_index, ai_completion |
| Gözlemlenebilirlik (4) | get_project_metrics, list_slow_queries, list_active_queries, cancel_query |
| Gerçek zamanlı (3) | list_realtime_channels, get_realtime_settings, update_realtime_settings |
| Proje (4) | project_info, switch_project, get_active_project, list_all_projects (yönetim kanalı) |
| API anahtarları (3) | create_api_key, list_api_keys, revoke_api_key (yönetim kanalı) |
| Dokümantasyon (1) | search_docs — gömülü belgelerde arama yapın (İngilizce) |
*_sql_function / *_sql_trigger araçları, proje şemasında depolanan gerçek PostgreSQL işlevlerini ve tetikleyicilerini oluşturur — list_functions / deploy_function (Edge Functions WASM, ayrı bir çalışma zamanı) ile ilgisi yoktur.
URL ile bağlanan istemciler için HTTP modu#
stdio varsayılan aktarımdır. http modu (Yayınlanabilir HTTP, MCP protokolleri 2025-11-25 ve 2026-07-28):
- varsayılan olarak
127.0.0.1'yi dinler (bunu değiştirmek için--host); - bir belirteç gerektirir (
--auth-tokenveya Taşıyıcı belirteci) — bu olmadan sunucu başlamayı reddeder; Originbaşlığını doğrular ve yetkisiz bir kaynağa 403 yanıtı verir (CSRF karşıtı koruma);- sona erme tarihi ve yapılandırılabilir sınırla birlikte oturum başına bir sunucu örneği;
- Belirteçleri sabit zamanda karşılaştırır ve istek gövde boyutunu sınırlar.