Skip to main content
Glama
Digital-Vereinfacht

DVBase MCP Server

DVBase MCP Server

MCP Server für Digital Vereinfacht – gibt Claude direkten Zugriff auf das Ninox-Datenmodell der DVBase.

Was macht das?

Claude kann damit:

  • Tabellen & Felder eurer Ninox-DB einsehen (Schema)

  • Daten abfragen via Ninox-Script (select Rechnungen where Status = "Offen")

  • Kontextwissen lesen (Prozessbeschreibungen, Stolperfallen, n8n-Abhängigkeiten)

Related MCP server: mysql-explorer

Installation (auf eurem Server)

1. Dateien auf den Server kopieren

# Archiv hochladen (z.B. per scp)
scp dvbase-mcp-server.tar.gz user@euer-server:~/

# Auf dem Server entpacken
ssh user@euer-server
tar xzf dvbase-mcp-server.tar.gz
cd dvbase-mcp-server

2. Dependencies installieren

npm install

3. Konfiguration (.env)

cp .env.example .env
nano .env

Dann ausfüllen:

# Ninox API Key (Zahnrad → Integrationen → Generate)
NINOX_API_KEY=euer-key-hier

# Aus der Ninox-URL: https://app.ninox.com/#/teams/TEAM_ID/databases/DB_ID
NINOX_TEAM_ID=eure-team-id
NINOX_DATABASE_ID=eure-database-id

# Sicherheits-Token – generieren mit: openssl rand -hex 32
MCP_AUTH_TOKEN=euer-geheimer-token-hier

PORT=3001

4. Bauen & starten

npm run build
npm start

Testen ob's läuft:

curl http://localhost:3001/health
# → {"status":"ok","server":"dvbase-mcp","authEnabled":true, ...}

5. Mit nginx nach außen freigeben (für Claude.ai)

In eurer nginx-Konfig (z.B. /etc/nginx/sites-available/default):

location /mcp {
    proxy_pass http://localhost:3001/mcp;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;

    # Wichtig für SSE/Streaming:
    proxy_set_header Connection '';
    proxy_buffering off;
    proxy_cache off;
    chunked_transfer_encoding on;
}
sudo nginx -t && sudo systemctl reload nginx

6. Dauerhaft laufen lassen (pm2)

# pm2 installieren falls noch nicht vorhanden
npm install -g pm2

# Server als Daemon starten
pm2 start dist/index.js --name dvbase-mcp

# Autostart nach Reboot
pm2 save
pm2 startup

Verbindung herstellen

Claude.ai (Browser)

  1. Gehe zu claude.ai → Settings → Integrations → MCP

  2. Trage ein:

    • URL: https://eure-domain.de/mcp

    • Auth: Bearer Token → euer MCP_AUTH_TOKEN

Claude Desktop App

In ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dvbase": {
      "url": "http://localhost:3001/mcp",
      "headers": {
        "Authorization": "Bearer EUER_MCP_AUTH_TOKEN"
      }
    }
  }
}

Verfügbare Tools

Tool

Beschreibung

list_modules

Zeigt alle Tabellen der DVBase

get_schema

Felder, Typen, Optionen einer Tabelle

get_context

Entwickler-Kontextwissen (braucht Doku-Tabelle)

get_full_module_info

Schema + Kontext kombiniert

query_data

Ninox-Script Abfragen ausführen

Doku-Tabelle (optional)

Für get_context und get_full_module_info braucht ihr eine Tabelle in Ninox mit diesen Feldern:

Feld

Typ

Inhalt

Modul

Text

Modulname (z.B. "Bautagesbericht")

Prozessbeschreibung

Text

Wie das Modul funktioniert

Stolperfallen

Text

Bekannte Probleme & Gotchas

N8N_Abhaengigkeiten

Text

Welche n8n-Workflows damit interagieren

Kundenspezifisch

Text

Kundenspezifische Anpassungen

Tabellen_Mapping

Text

Zugehörige Tabellen-IDs, komma-getrennt (z.B. "A,B,C")

Die Table-ID dieser Tabelle kommt als DOKU_TABLE_ID in die .env.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables querying and managing a CRM database through natural language conversations with Claude Desktop.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude to interact with a MySQL database by automatically discovering its schema and retrieving full table data for analysis.
    -
  • A
    license
    A
    quality
    C
    maintenance
    Provides Claude with read-only access to local development databases (Postgres, MySQL, SQLite) to inspect schemas, run SELECT queries, and explain query plans without leaving the conversation.
    5
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude to query and manage databases (SQLite, SQL Server, PostgreSQL, MySQL) through natural language, supporting read/write operations and schema management.
    544 npm
    MIT