
hatrigt/hana-mcp-server
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
hatrigt/hana-mcp-server는 MCP 서버 후보가 https://github.com/hatrigt/hana-mcp-server.에서 수입되었습니다
개요
hatrigt/hana-mcp-server는 MCP 서버 후보가 https://github.com/hatrigt/hana-mcp-server.에서 수입되었습니다
개요(AI 번역)
SAP HANA MCP Server는 SAP HANA와 SAP HANA Cloud를 위한 Model Context Protocol을 구현합니다. AI 클라이언트는 스키마를 발견하고, 가드 레일을 사용하여 SQL을 실행하고, business/domain metadata를 통합하여 데이터베이스를 기록 시스템으로 교체할 수 있습니다.
| 문서 | 목적 |
|---|---|
| 이 README | 필수품, 설치, **각 클라이언트를 타는 방법 **, 기능 요약, 구성 속임수 시트, 문제 해결 |
| CHANGELOG.md | **개요 ** - 버전별 기능 및 수정 (최신 0.3.1) |
| docs/README.md | /docs의 인덱스 |
| docs/ENVIRONMENT.md | Authoritative env reference: 모든 변수, 기본값, hard bounds, HTTP auth, 보안 노트 |
| docs/configuration-samples.md | Copy-paste: 연결 프로파일(single-container, MDC), semantics JSON, paging pointers |
| docs/local-http-mcp.md | Local HTTP MCP: npm run start:http, Cursor mcp.json, curl Smoke checks |
✅ 문의
- **Node.js ** 18 +
- A SAP HANA 또는 SAP HANA Cloud 데이터베이스는 서버 실행에서 SQL 포트에 도달
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
SAP HANA MCP Server
SAP HANA MCP Server implements the Model Context Protocol for SAP HANA and SAP HANA Cloud. AI clients discover schema, run SQL with guardrails, and optionally merge business/domain metadata so agents interpret codes and tables consistently—without replacing your database as the system of record.
📚 Documentation
| Document | Purpose |
|---|---|
| This README | Prerequisites, install, how to wire each client, capability summary, configuration cheat sheet, troubleshooting |
| CHANGELOG.md | Release history — features and fixes by version (latest 0.3.1) |
| docs/README.md | Index of /docs |
| docs/ENVIRONMENT.md | Authoritative env reference: every variable, defaults, hard bounds, HTTP auth, security notes |
| docs/configuration-samples.md | Copy-paste: connection profiles (single-container, MDC), semantics JSON, paging pointers |
| docs/local-http-mcp.md | Local HTTP MCP: npm run start:http, Cursor mcp.json, curl smoke checks |
✅ Prerequisites
- Node.js 18+
- A SAP HANA or SAP HANA Cloud database reachable on the SQL port from the machine running the server
- An MCP client (Claude Desktop, Claude Code, VS Code, Cursor, Cline, Windsurf, or custom HTTP client)
- Credentials supplied via env (see Security)
📦 Installation
| Method | Use when |
|---|---|
npx + -y hana-mcp-server in MCP config |
Default — no global install |
npm install -g hana-mcp-server |
You need hana-mcp-server on PATH |
Clone + node hana-mcp-server.js |
Developing or pinning a local build |
HTTP entrypoint (from a clone): npm run start:http — default bind 127.0.0.1:3100, path /mcp. See Hosted & HTTP.
🎯 Use cases
| Audience | Transport | Next step |
|---|---|---|
| Chat / lite users | stdio | Claude Desktop |
| Developers (Claude Code, VS Code, Cline, Cursor, Windsurf) | stdio | IDEs & code agents |
| Business apps with AI agents (you host MCP over HTTP) | HTTP | Hosted & HTTP |
🖥️ Claude Desktop
- Config file path:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\claude\claude_desktop_config.json
- macOS:
설치
npx -y hana-mcp-server설정
{
"mcpServers": {
"HANA Database": {
"command": "npx",
"args": ["-y", "hana-mcp-server"],
"env": {
"HANA_HOST": "your-hana-host.com",
"HANA_PORT": "443",
"HANA_USER": "your-username",
"HANA_PASSWORD": "your-password",
"HANA_SCHEMA": "your-schema",
"HANA_SSL": "true",
"HANA_ENCRYPT": "true",
"HANA_VALIDATE_CERT": "true",
"HANA_CONNECTION_TYPE": "auto",
"HANA_INSTANCE_NUMBER": "10",
"HANA_DATABASE_NAME": "HQQ",
"LOG_LEVEL": "info",
"ENABLE_FILE_LOGGING": "true",
"ENABLE_CONSOLE_LOGGING": "false"
}
}
}
}