sap-b1-hana-mcp

MCP-Server (Model Context Protocol) zum Abfragen von SAP B1 HANA mit direktem SQL über den offiziellen SAP-Treiber (@sap/hana-client).

Ohne Installation: Er wird mit npx direkt aus diesem GitHub-Repository ausgeführt. Es müssen lediglich Umgebungsvariablen definiert werden.

Verwendung

1. Voraussetzungen

• Node.js 20+ (nur auf der Maschine, die den Agenten ausführt; vom MCP wird nichts installiert).

2. Registrierung in opencode (oder einem anderen MCP-Client)

Füge diesen Block zu deiner opencode-Konfiguration hinzu (z. B. ~/.config/opencode/opencode.json):

{
  "mcp": {
    "sap-b1-hana": {
      "type": "local",
      "command": ["npx", "-y", "github:leonardows1/sap-b1-hana-mcp"],
"environment": {
        "HANA_HOST": "192.168.1.100",
        "HANA_PORT": "30015",
        "HANA_USER": "USUARIO_HANA",
        "HANA_PASSWORD": "TU_CONTRASEÑA",
        "HANA_DATABASE": "MI_TENANT",
        "HANA_SCHEMA": "MI_EMPRESA",
        "HANA_READONLY": "true"
      },
      "enabled": true
    }
  }
}

Hinweis: Die erste Ausführung von npx lädt das Paket herunter und installiert es; das kann mehr als 5 Sekunden dauern. Wenn der MCP-Client beim Start einen Timeout meldet, erhöhe "timeout": 60000 im Block.

3. Umgebungsvariablen

Related MCP server: SAP MCP Server

MCP-Tools

Wichtig zu SQL und SAP B1

Die Tabellen und Spalten von SAP B1 verwenden gemischte Groß- und Kleinschreibung und sind groß-/kleinschreibungsempfindlich: Spaltennamen müssen in doppelte Anführungszeichen gesetzt werden:

SELECT "ItemCode", "ItemName", "OnHand" FROM OITM WHERE "OnHand" > 0 ORDER BY "OnHand" DESC

Ohne Anführungszeichen wandelt HANA in Großbuchstaben um und die Abfrage schlägt mit invalid column name fehl.

Nur-Lese-Modus

Mit HANA_READONLY=true (Standard) lehnt der Server jede Anweisung ab, die nicht SELECT, WITH, EXPLAIN, SHOW oder DESCRIBE ist. Zum Aktivieren von Schreibzugriffen verwende HANA_READONLY=false — auf eigene Verantwortung.

Entwicklung

npm install
npm run build      # compila TypeScript a dist/
npm test           # tests unitarios (vitest)

Der Ordner dist/ wird kompiliert und versioniert. Das ist es, was npx github:... ausführt, ohne dass auf der Maschine des Benutzers ein Build nötig ist.

Architektur

Schichten mit manueller Abhängigkeitsinjektion und SOLID-Prinzipien:

src/
├── index.ts              Composition root: DI, host MCP (stdio)
├── configuration/        HanaOptions + validación de variables de entorno
├── domain/               Modelos: QueryResult, SchemaInfo, TableInfo, ColumnInfo, StatementKind
├── application/          Abstracciones de servicios + ISqlGuard (Strategy) + clasificador SQL
├── infrastructure/       Única capa que toca @sap/hana-client: factory de conexión,
│                         servicios de consulta/esquema, mapeo de datos (Buffer→base64, Date→ISO)
└── mcp/                  Adaptadores delgados: registro de tools MCP

Lizenzen

• Dieses Projekt: MIT.

• Treiber @sap/hana-client: SAP Developer License Agreement (wird als npm-Abhängigkeit vertrieben, nicht in diesem Repository versioniert). Siehe node_modules/@sap/hana-client/developer-license-3_2.txt.