SAP HANA CLI

Name: SAP HANA CLI
Author: SAP-samples

作者：SAP-samplesバージョン 4.202607.1i★ 115iパソコンで動く

レジストリ名io.github.SAP-samples/hana-cli

インストール

概要

作者による説明（英語の原文）

150+ SAP HANA database tools as MCP tools for AI assistants

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi2項目中2項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i成長中↓ 1638/週 · ★ 115

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 開発者ツール

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：2項目中2項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
レジストリには、入力が必要なキーは載っていません。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "hana-cli": {
      "command": "npx",
      "args": [
        "-y",
        "hana-cli"
      ]
    }
  }
}

ターミナルでこれを実行します

claude mcp add hana-cli -- npx -y hana-cli

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "hana-cli": {
      "command": "npx",
      "args": [
        "-y",
        "hana-cli"
      ]
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "hana-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hana-cli"
      ]
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月11日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント SAP-samples で確認済みです
✓ 合格
今もメンテナンスされている
コードの最終更新：30 日前
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

開発者ツールのほかのサーバーとの比較i

このカテゴリのほかの5736件のうち96%よりスターが多い
このカテゴリのほかの5736件のうち22%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの5736件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

SAP HANA CLIは安全ですか？

当てはまる基本チェック2項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は30 日前、最新バージョン（4.202607.1）がレジストリに届いたのは4 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：REA, Netdata, Front-End Checklist

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

作者：morluto広く使われている↓ 38.9万/週★ 44.8万16 日前更新

パソコンで動く

インストール

Netdata

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

作者：netdata広く使われている★ 8.1万6 日前更新

クラウドで動く

インストール

Front-End Checklist

Review frontend code and live pages against 386 quality-gated web development rules.

作者：thedaviddias広く使われている★ 7.5万37 日前更新

クラウドで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

SAP HANA Developer Command Line Interface

⚠️ Important Notice - Major Updates (Feb/March 2026)

Version 4.x introduces significant changes including Express 5 migration, refactored database connection handling, and major performance improvements. While we've tested extensively, please be aware of potential issues in your specific environment.

If you encounter problems:

Report Issues: Please open an issue on our GitHub Issues page with details about your environment and the problem you're experiencing.

Rollback to Stable Version: If you need to quickly revert to the last stable release before these major changes, you can install version 3.202601.0 (January 2026):

  npm install -g hana-cli@3.202601.0

What's Changed: The change log describes all notable changes including Express 5 migration, database connection refactoring, CLI startup performance optimization (60-77% faster), expanded test coverage (85%+ coverage), and the new VitePress documentation site.

📚 Documentation

Complete documentation is available in the [`docs/`](docs/) folder and organized with VitePress. This README will maintain a high-level overview and quick links to the most important sections of the documentation but over time expect that more and more detailed documentation will be added to the docs folder as the project evolves.

Quick Links:

[Getting Started](docs/01-getting-started/) - Installation and setup
[Command Reference](docs/02-commands/) - All 20+ commands with examples
[Features Guide](docs/03-features/) - CLI, API, MCP, and more
[API Reference](docs/04-api-reference/) - REST API documentation
[FAQ](docs/faq.md) - Frequently asked questions
[Troubleshooting](docs/troubleshooting.md) - Common issues and solutions

Run Documentation Locally

cd docs

npm install npm run docs:dev

Open http://localhost:5173

Build For Production

cd docs

npm run docs:build npm run docs:serve

See docs/README.md for complete documentation setup details.

Description

This sample is intended to shown how one could build a developer-centric SAP HANA command line tool, particularly designed to be used when performing local SAP HANA development in non-SAP tooling (like VSCode). It utilizes the default-env.json that is often used in local development for connectivity to a remote SAP HANA DB (although it can of course be used with a local SAP HANA, express edition instance as well). There is no intention to replacing the hdbsql tool as a generic SQL console. Instead this sample will focus on simplifying and grouping common and complex commands that otherwise might a lot of separate scripts.

Introduction Video: https://youtu.be/dvVQfi9Qgog

However the tool isn't limited to only local development. It also works well when developing in the cloud. The hana-cli tool can also run well from a cloud shell in the SAP Business Application Studio, Google Cloud Shell, AWS Cloud9, etc. We can also run against a SAP HANA service for SAP BTP or SAP HANA Cloud instance. This demonstrates that the tool can run just about anywhere you can get a command line that has access to the Node.js Runtime. We can also connect to a remote HANA instance even if it isn't running in the same cloud environment in which we are performing our development tasks.

Supported Environments

graph TD

A["SAP HANA CLI Tool"] --> B{Development Environment} B --> C["Local Development"] B --> D["Cloud Development"]

C --> C1["VSCode"] C --> C2["Local SAP HANA Express"] C --> C3["Remote SAP HANA"]

D --> D1["SAP Business App Studio"] D --> D2["Google Cloud Shell"] D --> D3["AWS Cloud9"] D --> D4["SAP BTP HANA Service"] D --> D5["SAP HANA Cloud"]

style A fill:#0070C0 style B fill:#FF6B6B style C fill:#51CF66 style D fill:#FFD93D

Running in Cloud Shells Video: https://youtu.be/L7QyVLvAIIQ

Requirements / Download and Installation

If you would rather just access the tool directly, it is now available in npm as well. You can install via:

npm install -g hana-cli

Installation Methods

graph LR

A["SAP HANA CLI Tool"] --> B{Installation Method}

B --> B1["NPM Package Quick Install"] B1 --> B1a["npm install -g hana-cli"] B1a --> B1b["✅ Ready to Use"]

B --> B2["Clone & Build From Source"] B2 --> B2a["Clone Repository from GitHub"] B2a --> B2b["Run npm install"] B2b --> B2c["Run npm link"] B2c --> B2d["✅ Ready to Use"]

style B1 fill:#0070C0,color:#fff style B2 fill:#FF6B6B,color:#fff style B1b fill:#51CF66,color:#fff style B2d fill:#51CF66,color:#fff

Otherwise you can also run it from the sources as described here:

Install Node.js on your development machine https://nodejs.org/en/download/. Version 22 or later is required; Node.js 24 (LTS) is highly recommended, following the SAP CAP 10 recommendation.

Clone the repository from https://github.com/SAP-samples/hana-developer-cli-tool-example

git clone https://github.com/SAP-samples/hana-developer-cli-tool-example

Run NPM install from the root of the hana-developer-cli-tool-example project you just cloned to download dependencies

npm install

Run NPM link from the cloned project root to make the hana-cli command available from everywhere https://docs.npmjs.com/cli/link

npm link

BTP CLI Installation

The hana-cli tool includes several commands that interact with SAP Business Technology Platform (BTP) services. All BTP-related functionality in this tool relies on the SAP BTP Command Line Interface (btp CLI) being installed and available in your system's PATH.

About the BTP CLI

The btp CLI is SAP's official command-line tool for managing resources and services on the SAP Business Technology Platform. It provides capabilities for managing global accounts, directories, subaccounts, entitlements, service instances, and more. The hana-cli tool wraps and extends many of these capabilities with developer-friendly commands.

Installing the BTP CLI with install-btp.sh

For Linux and macOS users, this repository includes a convenient installation script install-btp.sh that automates the installation of the BTP CLI.

The script performs the following actions:

Downloads the latest BTP CLI installer from the SAP Development Tools download page
Makes the installer executable and runs it with automatic confirmation
Configures shell aliases for easier BTP CLI usage
Adds the BTP CLI binary location to your PATH

To use the installation script:

chmod +x scripts/install-btp.sh

./scripts/install-btp.sh

After running the script, you may need to restart your terminal or run source ~/.bashrc to apply the PATH changes.

Note: Windows users should download the BTP CLI from the SAP Development Tools page and follow the platform-specific instructions there.

Verifying the Installation

Once installed, you can verify the BTP CLI is available by running:

btp --version

You can also use the hana-cli tool itself to check your BTP CLI configuration:

hana-cli btp

This will display your current BTP target information including global account, directory, and subaccount if configured.

Security

This application primarily uses the default-env.json that is often used in local development for connectivity to a remote HANA DB (although it can of course be used with a local SAP HANA, express edition instance as well). For more details on how the default-env.json works, see the readme.md of the @sap/xsenv package or the @sap/hdi-deploy package.

Connection Configuration Resolution Order

The tool doesn't simply look for a default-env.json file in the current directory however. There are numerous options and places it will look for the connection parameters. Here is the order in which it checks:

graph TD

A["Connection Resolution Started"] --> B{Admin Mode Enabled?} B -->|YES| B1["Look for default-env-admin.json"] B -->|NO| C{.cdsrc-private.json Found?}

B1 --> B2{Found?} B2 -->|YES| Z1["Use Admin Credentials"] B2 -->|NO| C

C -->|YES| C1["Use CAP cds bind Dynamic Lookup"] C -->|NO| D{.env File Found?}

C1 --> Z2["Secure Lookup from CF/K8s"]

D -->|YES| D1{Contains VCAP_SERVICES?} D1 -->|YES| Z3["Use VCAP Services"] D1 -->|NO| E D -->|NO| E

E{--conn Parameter Specified?} -->|YES| E1["Look for specified connection file"] E1 --> E2{Local or Home Found?} E2 -->|YES| Z4["Use Specified File"] E2 -->|NO| F E -->|NO| F

F["Look for default-env.json in current/parent dirs"] F --> G{Found?} G -->|YES| Z5["Use default-env.json"] G -->|NO| H["Last Resort: Look for default.json in HOME/.hana-cli/"]

H --> I{Found?} I -->|YES| Z6["Use default.json"] I -->|NO| Z7["❌ No Connection Configuration Found"]

style Z1 fill:#51CF66 style Z2 fill:#51CF66 style Z3 fill:#51CF66 style Z4 fill:#51CF66 style Z5 fill:#51CF66 style Z6 fill:#51CF66 style Z7 fill:#FF6B6B

First we look for the Admin option and use a default-env-admin.json - this overrides all other parameters
If no admin option or if there was an admin option but no default-env-admin.json could be found in this directory or 5 parent directories, then look for .cdsrc-private.json in this directory or 5 parent directories and use cds bind functionality to lookup the credentials securely. This is the most secure option, but please note: this will make each command take a few seconds longer as credentials are no longer stored locally but looked up from cf or k8s dynamically with each command
If no .cdsrc-private.json found in this directory or 5 parent directories, then look for a .env file in this directory or up to 5 parent directories
No .env file found or it doesn't contain a VCAP_SERVICES section, then check to see if the --conn parameter was specified. If so check for that file in the current directory or up to 5 parent directories
If the file specified via the --conn parameter wasn't found locally then check for it in the ${homedir}/.hana-cli/ folder
If no specific configuration file was was found then look for a file named default-env.json in the current directory or up to 5 parent directories
Last resort if nothing has been found up to this point - look for a file named default.json in the ${homedir}/.hana-cli/ folder

Examples

A lot of the functionality of this tool revolves around typical tasks you face while doing HANA database development. For example you might want to get a list of all views in your current schema/container:

C:\github\hana-xsa-opensap-hana7\user_db>hana-cli views

Schema: OPENSAP_HANA_USER, View: * SCHEMA_NAME VIEW_NAME VIEW_OID COMMENTS

冒頭だけを表示しています。続きはリポジトリで読めます

SAP HANA CLI

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

使えるアプリ

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

開発者ツールのほかのサーバーとの比較i

よくある質問

代わりの候補

REA

Netdata

Front-End Checklist

作者のREADME

SAP HANA Developer Command Line Interface

⚠️ Important Notice - Major Updates (Feb/March 2026)

📚 Documentation

Run Documentation Locally

Open http://localhost:5173

Build For Production

Description

Supported Environments

Requirements / Download and Installation

Installation Methods

BTP CLI Installation

About the BTP CLI

Installing the BTP CLI with install-btp.sh

Verifying the Installation

Security

Connection Configuration Resolution Order

Examples