SAP HANA MCP 服务器

SAP HANA MCP服务器

SAP HANA MCP服务器 实现 模型上下文协议 为了 萨普·哈纳 和 SAP HANA云.AI客户端发现模式，运行带有护栏的SQL，并可选择合并 业务/域元数据 因此，代理可以一致地解释代码和表，而无需将数据库替换为记录系统。

📚 文档

✅ 先决条件

• Node.js 18+
• A. 萨普·哈纳 或 SAP HANA云 从运行服务器的计算机在SQL端口上可访问的数据库
• 一 MCP客户端 （Claude Desktop、Claude Code、VS Code、Cursor、Cline、Windsurf或自定义HTTP客户端）
• 凭证 通过env提供（请参见 安全)

📦 安装

HTTP入口点 （来自克隆）： npm run start:http --默认绑定 127.0.0.1:3100，路径 /mcp。参见 托管和HTTP.

🎯 用例

🖥️ 克劳德桌面版

1. 配置文件路径：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • 窗户： %APPDATA%\claude\claude_desktop_config.json
   • Linux： ~/.config/claude/claude_desktop_config.json

2. 注册服务器；将连接设置放入 env （参见 配置；完整配置文件JSON 配置示例.md).以下示例包括 HANA_INSTANCE_NUMBER / HANA_DATABASE_NAME 为了 移动数据中心--如果使用单个容器数据库，请删除它们。

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

如果CLI已打开 PATH，您可以使用 "command": "hana-mcp-server" 并省略 args.

3. 重新启动克劳德桌面。

可选： HANA MCP UI — npx hana-mcp-ui 用于编辑envs并部署到Claude Desktop。

💻 IDE和代码代理

标准 只有；相同 env 按键如上。 典型示例——克劳德代码 (~/.claude.json 或项目 .mcp.json).这 env 下面的块包括 HANA_DATABASE_NAME 为了 MDC租户 哈娜；对于大多数单容器设置，省略它。

{
  "mcpServers": {
    "hana": {
      "type": "stdio",
      "timeout": 600,
      "command": "npx",
      "args": ["-y", "hana-mcp-server"],
      "env": {
        "HANA_HOST": "<host>",
        "HANA_PORT": "31013",
        "HANA_USER": "<user>",
        "HANA_PASSWORD": "<password>",
        "HANA_SCHEMA": "SAPABAP1",
        "HANA_DATABASE_NAME": "HQQ",
        "HANA_SSL": "false",
        "HANA_ENCRYPT": "false",
        "HANA_VALIDATE_CERT": "false",
        "LOG_LEVEL": "info",
        "ENABLE_FILE_LOGGING": "true",
        "ENABLE_CONSOLE_LOGGING": "false"
      }
    }
  }
}

使用相同 command, args，以及 env 在VS Code、Cline、Cursor和Windsurf中。更改后 env，在IDE中重新启动MCP服务器连接。

🌐 托管和HTTP

运行HTTP传输 从该存储库的签出 （之后 npm install).已出版 npx hana-mcp-server 路径是 标准 只有。

npm run start:http

基于HTTP的游标/本地IDE： 集 HANA_* 在运行的shell（或进程管理器）中 start:http，然后添加一个HTTP MCP条目 url http://127.0.0.1:3100/mcp ("type": "fetch" 或 "type": "http"，具体取决于游标版本）。看 docs/local-http-mcp.md 和 ./scripts/start-http-mcp.sh.

可选承载JWT（OAuth2/OIDC）

SAP BTP： 绑定XSUAA， MCP_HTTP_AUTH_ENABLED=true，分配角色集合。细节： 环境md§7.

🔒 安全

• 秘密： HANA_PASSWORD、JWT材料和带有嵌入式凭据的URL属于env或秘密管理器，而不是git。
• 供应链： 更喜欢 npx -y 从CI和共享桌面中发布的包中，而不是可变的全局安装。
• HTTP： 为本地主机之外的任何内容启用JWT验证；将服务置于TLS终止和网络策略的反向代理之后。

进一步说明： 环境md§9.

🎯 能力

34工具 在HANA Cloud上验证了六个领域。

🛠️ 配置

变量适用于 标准 (env 在客户端配置中）以及 超文本传输协议 （工艺环境）。 重启 更改后。

名称、默认值和钳位范围的真实来源： docs/ENVIRONMENT.md.
复制粘贴连接JSON（单容器/MDC）： docs/configuration-samples.md#连接配置文件env json.

必需

连接和TLS

日志记录

*代码默认值；示例经常将文件日志设置为 true.

限制（查询、列表、资源）

DML权限

INSERT、UPDATE和DELETE是 默认情况下被阻止。将每个设置为 true 允许：

业务/域JSON(HANA_SEMANTICS_*)

样品： 配置示例.md.

🔧 故障排除

调试： LOG_LEVEL=debug, ENABLE_CONSOLE_LOGGING=true，重新启动。

客户端找不到 npx (spawn ENOENT)

从Dock或开始菜单启动的GUI客户端（Claude Desktop、Cursor、VS Code等）继承了最小的 PATH 并且可能看不到安装在下面的节点工具 /opt/homebrew/bin, ~/.nvm/..., mise，或 volta。这会影响 每 npx-基于MCP，而不仅仅是这个服务器。MCP客户端日志中显示的错误为：

Connection failed: spawn npx ENOENT

挑选 一 修复：

1. 符号链接 npx / node 进入GUI可见路径 （macOS、Homebrew）：

   复制

   ln -s "$(which npx)"  /usr/local/bin/npx
   ln -s "$(which node)" /usr/local/bin/node
   

2. 在MCP配置中使用绝对路径 --最便携，没有 PATH 附属国。解析路径 which node 和 npm root -g:

   复制

   {
     "mcpServers": {
       "hana": {
         "type": "stdio",
         "command": "/opt/homebrew/bin/node",
         "args": ["/opt/homebrew/lib/node_modules/hana-mcp-server/hana-mcp-server.js"],
         "env": { "HANA_HOST": "...", "HANA_USER": "...", "HANA_PASSWORD": "..." }
       }
     }
   }
   

   需要一次性 npm install -g hana-mcp-server.

3. 注入 PATH 进入MCP env 块 --保持 npx 形式：

   复制

   "env": {
     "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
     "HANA_HOST": "...",
     "HANA_USER": "...",
     "HANA_PASSWORD": "..."
   }
   

更改后重新启动MCP客户端。如果 npx 然后失败 EPERM 上 ~/.npm/_cacache，npm缓存中有以前根目录下的文件 sudo npm --修复与 sudo chown -R "$(whoami)" ~/.npm 或设置 "NPM_CONFIG_CACHE": "/tmp/hana-mcp-npm-cache" 同样地 env 块。

🖥️ HANA MCP UI

npx hana-mcp-ui

🏗️ 建筑

hana-mcp-server/
├── src/
│   ├── server/           # MCP lifecycle, resources, HTTP transport
│   ├── tools/            # 34 tools: schema, SQL, discovery, config
│   ├── database/         # HANA client, connection pool, executor, query runner
│   ├── semantics/        # Optional semantics / domain JSON loader
│   ├── utils/            # Logger, config, validators, formatters
│   ├── query-snapshot-store.js
│   └── constants/        # MCP constants, tool definitions
├── tests/
├── docs/                 # README index, ENVIRONMENT.md, configuration-samples.md, diagrams
└── hana-mcp-server.js    # stdio entry point

📦 包裹

🤝 支持

• 问题： GitHub问题
• UI： HANA MCP UI

📄 许可证

麻省理工学院——见 许可证.