Tabellum

Tabellum — MCP 配置

让你的 AI 助手通过 Tabellum 操作数据库。Tabellum 是一款桌面数据库客户端，支持 PostgreSQL、MySQL/MariaDB、SQL Server 和 BigQuery。MCP 服务由你电脑上正在运行的应用托管；此软件包是一个小型 stdio 转接程序，会将请求转发给它。助手编写的查询会实时显示在编辑器中，任何会更改数据的操作都必须由你在应用中点击确认后才会运行。

• 服务： tabellum
• 传输方式： stdio（本地进程）
• 软件包： @dudko.dev/tabellum-mcp — Node.js 24+
• 身份验证： 应用生成的安装专属令牌；转接程序会从 ~/.tabellum/mcp.json 中读取令牌。

你可以做什么

打开 Tabellum 应用后，助手就能使用与应用内置 Agent 相同的工具——这些工具由应用提供，因此列表会随应用版本变化。读取操作会立即执行；任何写入操作都必须在应用中由你点击确认。

工具	功能
查看信息
list_connections	列出连接名称、驱动程序和只读标记。不包含主机或用户信息。
describe_schema	列出连接中的每个架构及其表、视图、函数、过程和序列名称。
describe_object	查看一个对象的列、索引、约束和 CREATE 语句。
list_users	列出数据库中记录的用户和角色及其标记。
sample_rows	获取表中最多 N 行数据——仅适用于连接允许共享行数据的情况。
查询
run_read	仅当引擎将语句判定为读取操作时才运行；其他任何语句都会返回 needs_approval。
explain	查看读取操作的估算执行计划；不会运行任何操作。
propose_write	提交写入、DDL 或管理语句，等待你在应用中批准（超时为 10 分钟）。
open_editor_tab	打开一个与连接关联的查询标签页。
draft_to_editor	在你查看时将 SQL 输入标签页，但不运行。
比较架构
compare_schemas	将一个连接与另一个连接或已保存的快照进行差异比较；设为 migration: true 时，会生成用于弥合差异的语句。不会运行任何操作。
save_schema_snapshot / list_schema_snapshots	将连接的架构保存到工作区；列出快照。
仪表板
list_dashboards / get_dashboard	查看工作区的仪表板；查看某个仪表板的文件和面板。
propose_dashboard	提交新建或修改的仪表板——你可以查看差异并应用。
架构设计
list_designs / get_design	查看工作区的架构设计；查看某个设计的文件和对象。
propose_design	提交新建或修改的设计——你可以查看新增、变更和移除的内容。不会对数据库运行任何操作。
describe_feature	查看 designer、dashboards 或 schema_compare 的文件格式和规则；请在提交方案前阅读。

供偏好使用资源的客户端使用：tabellum://connections、 tabellum://schema/<connection>、tabellum://snapshots、 tabellum://dashboards、tabellum://designs。每次调用都会在应用中标记来源——标签页上会显示标记，Agent 日志中也会有记录。

---

在 Claude Code 中安装（插件）

/plugin marketplace add dudko-dev/tabellum-mcp-setup
/plugin install tabellum@tabellum
/reload-plugins

请先启动 Tabellum 应用（macOS、Windows 或 Linux）。转接程序会从 ~/.tabellum/mcp.json 读取应用的本地端口和令牌；该文件会在应用运行时写入。应用关闭时，每次调用都会返回“Tabellum is not running”。

不想使用市场？直接添加服务：

claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcp

---

从其他客户端连接

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

VS Code（GitHub Copilot / MCP）及其他客户端

{
  "servers": {
    "tabellum": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

---

安全

• 由引擎分类，由你审批。 应用的解析器会对每条语句进行分类；任何非读取操作都会经过 propose_write，并等待你点击批准。模型声称的标签绝不会覆盖解析器的分类。
• 仅限环回连接。 应用会在 127.0.0.1 上监听，并使用每次安装独有的 bearer token（在 Settings → Agents 中可查看和重新生成）。
• 每个连接的数据行共享均为可选。 sample_rows 只会返回你为相应连接启用了共享的数据行。

---

故障排除

• “Tabellum 未运行” — 打开应用后重试。
• 重新生成 token 后提示未授权 — 在客户端中重启 MCP 服务，以便 shim 重新读取 ~/.tabellum/mcp.json。
• 写入似乎卡住了 — 操作正在应用中等待审批；10 分钟后会返回 declined: timeout。

支持

• 网站：https://tabellum.dudko.dev
• 联系方式：[email protected]