@clidey/whodb-cli (英语)

WhoDB CLI - 一个强大的数据库管理工具,具有交互式TUI,程序命令,以及用于AI助手的MCP服务器.

安装此软件包提供了 whodb 命令。 如果你宁愿用一个 命名空格软件包名称, 安装 @clidey/whodb 相反,两者提供相同的命令.

安装

# Run directly (no install required)
npx @clidey/whodb-cli --help

# Or install globally
npm install -g @clidey/whodb-cli

两种安装方法都提供了 whodb 命令.

特征

• 互动 TUI: 数据库管理的完整终端 UI
• 程序命令: 从脚本查询、导出和管理数据库
• MCP 服务器: 与 Claude Desktop、 Claude Code 和其他 MCP 客户端整合
• 助理整合: 为 Codex 、 Claude 代码、 Cursor 、 VS 代码、 GitHub 副驾驶 CLI 、 双子座 CLI 、 Windsurf 、 OpenCode 、 Cline 、 Zed 、 继续 和 辅助器安装随时可用的 MCP 配置

支持的数据库

• 邮递SQL
• MySQL / 马里亚DB
• SQL 点
• 蒙戈DB
• 重写
• 弹性搜索
• 点击之家

使用量

互动模式( TUI)

npx @clidey/whodb --tui

程序命令

# Query a database
npx @clidey/whodb query "SELECT * FROM users LIMIT 10" --connection mydb

# List schemas
npx @clidey/whodb schemas --connection mydb --format json

# List tables
npx @clidey/whodb tables --connection mydb --schema public

# Describe columns
npx @clidey/whodb columns --connection mydb --table users

# Export data
npx @clidey/whodb export --connection mydb --table users --format csv --output users.csv

MCP 服务器模式

MCP平台为默认. 签名到每个主机,然后启动服务器 :

npx @clidey/whodb login --host <url>
npx @clidey/whodb mcp serve

使用 workspace: {host, org, project} 平台工具呼叫以锁定特定 不更改已保存的默认值的工作空间 .

对于只使用数据库的工具,启用数据库模块 npx @clidey/whodb setup。服务器命令保持不变 :

npx @clidey/whodb mcp serve

写操作需要默认确认. 使用 --allow-write 以禁用确认或 --read-only 来阻止写作.

限制大赦国际访问与 --allowed-connections数字 :

npx @clidey/whodb mcp serve --database --allowed-connections prod,staging

只有数据库的 MCP 客户端配置

示例配置(从 whodb mcp serve --database --help:

{
  "mcpServers": {
    "whodb": {
      "command": "whodb",
      "args": ["mcp", "serve"],
      "env": {
        "WHODB_POSTGRES_1": "{\"alias\":\"prod\",\"host\":\"localhost\",\"user\":\"user\",\"password\":\"pass\",\"database\":\"db\"}"
      }
    }
  }
}

助理集成安装器

用捆绑的 CLI 安装本地助手配置 :

npx @clidey/whodb skills install --target cursor
npx @clidey/whodb skills install --target vscode
npx @clidey/whodb skills install --target gemini-cli
npx @clidey/whodb skills install --target claude-code --include-agents
npx @clidey/whodb skills install --target cursor --dry-run

支助目标: codex, (中文(简体) ), claude-code, (中文(简体) ), cursor, (中文(简体) ), vscode, (中文(简体) ), github-copilot, (中文(简体) ), gemini-cli, (中文(简体) ), windsurf, (中文(简体) ), opencode, (中文(简体) ), cline, (中文(简体) ), zed, (中文(简体) ), continue,以及 aider。 。 。 .

现有的JSON和JSONC配置文件被合并到位并被重写为格式化的JSON. 在重写已有的 JSON 或 YAML 助手配置之前, 原始文件保存在旁边为 <filename>.whodb.bak。 。 。 . 使用 --dry-run 预览创建或更新的文件和任何备份路径,而不写入更改.

环境变量

例如,通过环境配置配置配置数据库连接 WHODB_POSTGRES='[{"alias":"prod","host":"localhost","user":"user","password":"pass","database":"db","port":"5432"}]' 或者说 WHODB_MYSQL_1='{"alias":"dev","host":"localhost","user":"user","password":"pass","database":"devdb","port":"3306"}'。每个对象支持 alias (连接名称), host, (中文(简体) ), user, (中文(简体) ), password, (中文(简体) ), database, (中文(简体) ), port选择 config。 。 。 .

使用 alias 字段来设置连接名称(例如, prod) (中文(简体) ). 如果省略, CLI 将指定一个像 postgres-1。 。 。 .

可用的 MCP 工具

平台支持

此软件包会自动为您的平台安装正确的二进制 :

• macOS (英特尔和苹果硅)
• Linux (x64, ARM64, ARMv7) (中文(简体) )
• 视窗(x64,ARM64)

链接

• GitHub 仓库
• 文档

许可证

阿帕奇 - 2.0