hatrigt/hana-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

73 stars 30 forks 质量 91 趋势 28MIT

Repository Install

hatrigt/hana-mcp-server 是从 https://github.com/hatrigt/hana-mcp-server. 导入的 MCP 服务器候选

概览

hatrigt/hana-mcp-server 是从 https://github.com/hatrigt/hana-mcp-server. 导入的 MCP 服务器候选

概述（AI 翻译）

SAP HANA MCP 服务器 实现了 SAP HANA 和 SAP HANA 云的模型上下文协议。AI 客户端发现模式，运行带保护栏的 SQL，并可选合并 业务/域元数据，使代理能够一致解释代码和表格——而无需取代你的数据库作为记录系统。

📚 文献资料

文档	目的
此说明	前置条件，安装，如何接线每个客户端，功能摘要，配置速查表，故障排除
CHANGELOG.md	发布历史 — 按版本（最新`0.3.1`）的功能和修复
docs/README.md	`/docs` 索引
docs/ENVIRONMENT.md	权威环境引用：每个变量、默认值、硬边界、HTTP认证、安全说明
docs/configuration-samples.md	复制粘贴：连接配置文件（单容器，MDC）、语义JSON、分页指针
docs/local-http-mcp.md	本地 HTTP MCP： `npm run start:http`， Cursor `mcp.json`， curl smoke checks

✅ 先修条件

Node.js 18+
可通过运行服务器的机器通过SQL端口访问的SAP HANA HANA Cloud**数据库

本页由 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

在 GitHub 查看完整 README

安装

npx -y hana-mcp-server

新手？先看 mcpskill.org 教程 →

配置

{
  "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"
      }
    }
  }
}