sap-b1-hana-mcp

MCP-сервер (Model Context Protocol) для запросов к SAP B1 HANA с помощью прямого SQL через официальный драйвер SAP (@sap/hana-client).

Без установки: запускается с помощью npx напрямую из этого репозитория GitHub. Нужно только задать переменные окружения.

Использование

1. Требования

• Node.js 20+ (только на машине, где выполняется агент; ничего из MCP не устанавливается).

2. Регистрация в opencode (или другом MCP-клиенте)

Добавьте этот блок в свою конфигурацию opencode (например, ~/.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
    }
  }
}

Примечание: первый запуск npx загружает и устанавливает пакет и может занять более 5 секунд. Если MCP-клиент сообщает о тайм-ауте при запуске, увеличьте "timeout": 60000 в этом блоке.

3. Переменные окружения

Related MCP server: SAP MCP Server

Инструменты MCP

Важно об SQL и SAP B1

Таблицы и столбцы SAP B1 используют смешанный регистр и чувствительны к регистру: имена столбцов должны быть в двойных кавычках:

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

Без кавычек HANA преобразует всё в верхний регистр, и запрос завершается ошибкой invalid column name.

Режим только чтения

При HANA_READONLY=true (по умолчанию) сервер отклоняет любое выражение, не являющееся SELECT, WITH, EXPLAIN, SHOW или DESCRIBE. Чтобы разрешить запись, используйте HANA_READONLY=false — под вашу ответственность.

Разработка

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

Папка dist/ компилируется и версионируется: именно её запускает npx github:... без необходимости сборки на машине пользователя.

Архитектура

Слои с ручным внедрением зависимостей и принципами SOLID:

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

Лицензии

• Этот проект: MIT.

• Драйвер @sap/hana-client: SAP Developer License Agreement (распространяется как зависимость npm и не версионируется в этом репозитории). См. node_modules/@sap/hana-client/developer-license-3_2.txt.