taurusdb-mcp

TaurusDB MCP server for MCP clients such as:

• Claude Code
• Codex
• Cursor
• VS Code

Install

npm install taurusdb-mcp

Run directly with:

npx -y taurusdb-mcp --version

Use this command in MCP client configs:

{
  "command": "npx",
  "args": ["-y", "taurusdb-mcp"]
}

Claude Code:

claude mcp add huaweicloud-taurusdb \
  --transport stdio \
  -e TAURUSDB_CLOUD_REGION=<your-region> \
  -e TAURUSDB_CLOUD_ACCESS_KEY_ID=<your-ak> \
  -e TAURUSDB_CLOUD_SECRET_ACCESS_KEY=<your-sk> \
  -e TAURUSDB_SQL_DATABASE=<your-database> \
  -e TAURUSDB_SQL_USER=<your-readonly-user> \
  -e TAURUSDB_SQL_PASSWORD='hw-kms-file:~/.taurusdb-mcp/password.ciphertext' \
  -- npx -y taurusdb-mcp

Codex:

codex mcp add huaweicloud-taurusdb \
  --env TAURUSDB_CLOUD_REGION=<your-region> \
  --env TAURUSDB_CLOUD_ACCESS_KEY_ID=<your-ak> \
  --env TAURUSDB_CLOUD_SECRET_ACCESS_KEY=<your-sk> \
  --env TAURUSDB_SQL_DATABASE=<your-database> \
  --env TAURUSDB_SQL_USER=<your-readonly-user> \
  --env TAURUSDB_SQL_PASSWORD='hw-kms-file:~/.taurusdb-mcp/password.ciphertext' \
  -- npx -y taurusdb-mcp

Initialize local MCP client config:

npx taurusdb-mcp init --client claude
npx taurusdb-mcp init --client cursor
npx taurusdb-mcp init --client vscode

Configure and verify the operating-system credential store:

npx taurusdb-mcp credentials configure
npx taurusdb-mcp credentials check

Notes

• Requires Node.js >= 20
• Depends on taurusdb-core
• Database passwords support env:, file:, hw-csms:, hw-kms:, and hw-kms-file: references
• Huawei DEW CSMS is recommended when the database password should be stored and retrieved from Huawei Cloud
• macOS Keychain, Linux Secret Service, or Windows Credential Manager cloud identity is enabled with TAURUSDB_CLOUD_KEYCHAIN_SERVICE