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. 환경 변수

변수

필수 여부

설명

예시

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