Skip to main content
Glama
deenesjakoruzh
leonardows1

sap-b1-hana-mcp

by leonardows1
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

sap-b1-hana-mcp

MCP (Model Context Protocol) サーバーで、SAP公式ドライバー (@sap/hana-client) 経由の直接SQLで SAP B1 HANA を照会します。

インストール不要: このGitHubリポジトリから直接 npx で実行できます。環境変数を定義するだけです。

使用方法

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. 環境変数

Variable

必須

説明

例

HANA_HOST

必須

HANA サーバーのホスト

192.168.1.100

HANA_PORT

任意 (デフォルト 30015)

HANA ポート (テナント)

30013

HANA_USER

必須

HANA ユーザー

USUARIO_HANA

HANA_PASSWORD

必須

パスワード

...

HANA_DATABASE

任意

HANA テナント (MDC)

MI_TENANT

HANA_SCHEMA

任意

スキーマ (SAP B1 の会社データベース)

MI_EMPRESA

HANA_READONLY

任意 (デフォルト true)

true = 読み取り専用クエリのみ; false = INSERT/UPDATE/DELETE/DDL を許可

true

HANA_SSL

任意 (デフォルト false)

true = 暗号化接続 (証明書の検証なし)

false

Related MCP server: SAP MCP Server

MCP ツール

ツール

説明

execute_query

SQL を実行し、JSON (columns, rows, rowCount, truncated) で行を返します。

check_connection

接続を確認します: データベース、バージョン、現在のスキーマ。

list_schemas

インスタンスのスキーマを一覧表示します (パターンによる任意のフィルター)。

list_tables

スキーマ内のテーブルを一覧表示します (パターンによる任意のフィルター)。

get_table_schema

テーブルの構造: 列、型、長さ、スケール、NULL 許可。

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 を参照してください。

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • MSSQL MCP Server

    daobataotie
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides database interaction and business intelligence capabilities, enabling users to run SQL queries, analyze business data, and automatically generate business insight memos for Microsoft SQL Server databases.
    39
    MIT

  • SAP MCP Server

    AmistaUS-AVA
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI clients to query live data from SAP HANA and SQL databases through read-only SELECT queries with CSV-formatted results.
    MIT

  • SQL Server MCP

    shaharwiener
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides secure, read-only access to Microsoft SQL Server with multi-layer protection, enabling safe query execution, schema discovery, and SQL script analysis through natural language.
    1

  • SQL Server MCP Server (Diamond

    DhruviPatel712
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables safe, read-only querying and schema exploration for Microsoft SQL Server databases with preconfigured Diamond Inventory support, multiple database management, and optional HTTP API.
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/leonardows1/sap-b1-hana-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server