HANA MCP Server — Distribución cliente

Paquete ejecutable del Model Context Protocol (MCP) server para SAP HANA y SAP Business One Service Layer.

📥 Descarga

Descargá la última versión desde Releases:

• hana-mcp-server-v0.3.1-win-x64.zip

Descomprimí el ZIP en una carpeta permanente, por ejemplo:

C:\hana-mcp-client\

✅ Requisitos

• Windows 10/11 o Windows Server 2019+ (x64)
• Acceso de red al servidor SAP HANA
• Token de licencia JWT proporcionado por el vendor (si aplica)

No necesitás instalar Node.js: el ejecutable incluye su propio runtime.

🚀 Instalación rápida

1. Descomprimí el ZIP en la carpeta destino.
2. Copiá .env.example como .env y completá al menos:
   • HANA_HOST
   • HANA_PORT
   • HANA_USER
   • HANA_PASSWORD
   • HANA_SCHEMA
3. Si recibiste el token JWT como archivo, guardalo como .hana-license en la misma carpeta.
4. Ejecutá start.bat (doble clic) o configurá tu cliente MCP para que apunte a hana-mcp-server.exe.

⚙️ Configuración de .env

Ejemplo mínimo:

HANA_HOST=tu-servidor-hana
HANA_PORT=30015
HANA_USER=TU_USUARIO
HANA_PASSWORD=TU_PASSWORD
HANA_SCHEMA=TU_SCHEMA
HANA_SSL=false
HANA_VALIDATE_CERT=false

Ver .env.example para todas las opciones disponibles.

🔐 Licenciamiento

Obtené tu hardware ID ejecutando el servidor y consultando la tool hana_show_license_info. Enviale ese HWID al vendor para que genere tu token.

{
  "name": "hana_show_license_info",
  "arguments": {}
}

Una vez instalado el token, la misma tool debe reportar:

status: VALID
plan: enterprise
features: ["hana", "knowledge-base"]

🔌 Uso con Claude / VS Code / MCP Inspector

Ejemplo de mcp.json:

{
  "mcpServers": {
    "hana": {
      "type": "stdio",
      "command": "C:\\hana-mcp-client\\hana-mcp-server.exe"
    }
  }
}

🔄 Actualizaciones

El servidor nunca se actualiza solo. Cuando haya una nueva versión, el vendor la publicará en Releases. Podés consultarla con la tool hana_check_for_updates y aplicarla con hana_apply_update:

{
  "name": "hana_apply_update",
  "arguments": {
    "confirm": true
  }
}

El proceso preserva tus casos propios (docs/kb/user/), los casos sincronizados desde la nube (docs/kb/remote/) y tu configuración (.env, .hana-license, mcp.json). Los casos incluidos con el producto (docs/kb/bundled/) sí se actualizan.

📁 Contenido del paquete

• hana-mcp-server.exe — MCP empaquetado con Node.js.
• start.bat — lanzador para Windows.
• docs/kb/bundled/ — base de conocimiento incluida con el producto.
• docs/kb/user/ — casos que crees vos (vacío al inicio).
• docs/kb/remote/ — casos sincronizados desde el servidor remoto.
• node_modules/@sap/hana-client/ — driver nativo de SAP HANA.
• public-key.pem — clave pública para validar licencias.
• .env.example — plantilla de configuración.
• mcp.json.example — plantilla de configuración MCP.
• scripts/update-client.ps1 / update-client.sh — helpers de actualización.

📴 Modo offline (licencia vencida)

Si la licencia expira, el MCP no se cierra: entra en modo offline y mantiene disponible la base de conocimiento local en modo de solo lectura.

• Funcionan:
  • hana_search_knowledge_base
  • hana_read_kb_case
  • hana_generate_kb_index
  • hana_show_license_info
• No funcionan hasta renovar la licencia:
  • Todas las tools de consulta y administración de HANA.
  • Guardar nuevos casos (hana_save_knowledge_case).
  • Sincronización remota de KB.

🆘 Soporte

Para renovar la licencia, agregar hardware IDs adicionales o reportar problemas, contactá al vendor con el hardware ID mostrado por hana_show_license_info.