baraba/Baradb

Fork 0

Files

T

dimgigov a5d34c001a

CI / test (push) Has been cancelled

Details

CI / verify (push) Has been cancelled

Details

docs: add German (DE) documentation + update all docs for Sessions 10-12

New German documentation (docs/de/):
- index.md, quickstart.md, installation.md
- baraql.md, graph.md, vector.md, mcp.md

Updated English documentation:
- changelog.md: all Sessions 10-12 features
- graph.md: SQL GRAPH_TABLE, CREATE GRAPH, all 8 algorithms, Cypher, similarity_nodes, node2vec
- vector.md: hybrid RAG, chunk(), embed_text(), auto-embed, nl_to_sql(), schema_prompt()
- baraql.md: new AI & Cross-Modal Functions section, updated keyword tables
- mcp.md: MCP Server documentation (new file)
- index.md: added German (DE) language link

2026-05-17 16:15:45 +03:00

2.1 KiB

Raw Blame History

MCP Server (Model Context Protocol)

BaraDB enthält einen eingebauten MCP-Server, der es AI-Agenten (Claude, Cursor, etc.) ermöglicht, direkt mit der Datenbank zu interagieren.

Schnellstart

./build/baramcp --data-dir ./data

Der Server startet im STDIO-Modus und akzeptiert JSON-RPC 2.0 Nachrichten.

Verfügbare Tools

1. `query` — SQL ausführen

{
  "name": "query",
  "arguments": {
    "sql": "SELECT * FROM users WHERE age > ?",
    "params": [25],
    "tenant_id": "company-a",
    "user_id": "alice"
  }
}

Parameterisierte Abfragen mit ?-Platzhaltern. Multi-Tenant-Support über tenant_id und user_id.

2. `vector_search` — Semantische Suche

{
  "name": "vector_search",
  "arguments": {
    "table": "docs",
    "column": "embedding",
    "query_vector": [0.1, 0.2, 0.3],
    "k": 5,
    "metric": "cosine",
    "tenant_id": "company-a"
  }
}

Unterstützte Metriken: cosine, euclidean, dot_product, manhattan.

3. `schema_inspect` — Schema erkunden

{
  "name": "schema_inspect",
  "arguments": {
    "table": "users",
    "tenant_id": "company-a"
  }
}

Gibt Tabellen, Spalten, Typen, Primärschlüssel, Fremdschlüssel, Indizes und RLS-Policies zurück.

Konfiguration in Claude Desktop

{
  "mcpServers": {
    "baradb": {
      "command": "/pfad/zu/build/baramcp",
      "args": ["--data-dir", "/pfad/zu/daten"]
    }
  }
}

Konfiguration in Cursor

{
  "mcpServers": {
    "baradb": {
      "command": "/pfad/zu/build/baramcp",
      "args": ["--data-dir", "~/.baradb/data"]
    }
  }
}

Multi-Tenant Isolation

Jede MCP-Anfrage kann tenant_id und user_id enthalten. Diese werden als Session-Variablen gesetzt:

app.tenant_id — für RLS-Filterung
app.user_id — für current_user-Referenzen

RLS-Policies filtern die Daten automatisch basierend auf diesen Variablen.

JSON-RPC 2.0 Protokoll

Der Server verwendet JSON-RPC 2.0 über STDIO:

// Anfrage
{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {...}}

// Antwort
{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "..."}]}}

2.1 KiB Raw Blame History