第51章 TablePlus 第51章:MCP Server
偏好设置 MCP Server TablePlus 内置了 MCP(Model Context Protocol)服务器。借助它,Claude Code、Codex 等 AI 工具或任何其他 MCP 客户端都能列出你保存的连接、打开它们,并通过 TablePlus 执行查询。LLM Plugin 中的自定义 Agent 也是通过同一个服务器访问你的数据库。 服务器运行在你 Mac 上的 TablePlus 内。客户端使用访问令牌(access token)连接,由你决定每个令牌能做什么、能看到哪些连接。 开启服务器
打开 Settings > MCP。 勾选 Enable MCP Server。
状态栏会显示 MCP Server is Running on port: 51003(或你选择的端口)以及已连接客户端的数量。开启后,每次打开 TablePlus 时服务器都会自动启动。 你也可以通过 Open Anything 打开这个面板:按 ⌘ + P 并选择 MCP Server。 Preferences > MCP 服务器选项
选项 说明
Preferred Port 服务器监听的端口,默认为 51003。请使用 32000 到 61000 之间的端口。
Allow remote access (TLS) 允许其他机器通过 HTTPS 连接。默认情况下,服务器只接受来自本机的连接。
Export Certificate… 导出服务器的自签名 TLS 证书(tableplus-mcp.pem)。在远程机器上安装它,使其信任该服务器。仅在开启远程访问时可用。
Approval needed for unsafe query 对处于 Silent Mode 的连接,在客户端执行会修改数据或结构的查询前先征求你的确认。默认开启。参见 Query approval。
Auto-generate Access Token for tableplus-mcp 允许 tableplus-mcp 命令直接连接,无需你自己创建令牌。默认开启。
修改端口、远程访问或自动生成选项会重启服务器。 配置客户端 在 Client Setup 下,点击 Add to Claude Code、Add to Codex、Add to Grok Build 或 Add to Antigravity,把 TablePlus 添加到 Mac 上已安装的编码 Agent,然后重启该 Agent。点击 Others… 可添加 Cursor、VS Code (GitHub Copilot)、Cline、Kilo Code、OpenCode、Devin Desktop、Kiro、GitHub Copilot CLI、Factory Droid 和 Augment Code。某个 Agent 添加了 TablePlus 后,按钮会变为 Remove from …。如果 Agent 仍从旧位置运行 TablePlus(比如你移动了应用),按钮会显示 Update in …。 要手动配置其他客户端,点击 Manual Setup…,然后选择:
Manual:tableplus-mcp 命令的路径,适用于以本地(stdio)方式启动 MCP 服务器的客户端。
HTTP Server:端点地址(例如 http://127.0.0.1:51003/mcp),适用于通过 Streamable HTTP 连接的客户端。这类客户端会在 Authorization: Bearer
tableplus-mcp 是 TablePlus 应用包内的一个小命令(TablePlus.app/Contents/MacOS/tableplus-mcp)。它把客户端的请求转发给正在运行的服务器。如果 TablePlus 没有运行,它会先在后台启动 TablePlus。MCP 服务器必须处于开启状态。 如果关闭了 Auto-generate Access Token for tableplus-mcp,就无法一键添加 Agent。请改用 Manual Setup…:其 Manual 命令包含一个 TABLEPLUS_MCP_ACCESS_TOKEN 变量,把 YOUR_ACCESS_TOKEN 替换为你创建的令牌即可。 访问令牌 每个客户端都需要访问令牌。令牌决定客户端能做什么:
权限 客户端能做什么
Read Only 列出和打开连接,并执行 SELECT 等只读查询,其他查询会被拒绝。
Read & Write 包含 Read Only 的全部能力,并可执行任意查询,包括修改数据或结构的查询。
Full Access 拥有全部权限。
创建令牌
在 Settings > MCP 中,点击令牌列表下方的 Add。 输入 Token Name,比如客户端或机器的名称。 选择 Permissions。 在 Connection Access 下,选择 Allow All 授予所有已保存连接的访问权限,或选择 Limited 并勾选该令牌可使用的连接(或连接分组)。 点击 Generate Token。
请立即复制令牌,TablePlus 只会显示一次它的值。 创建访问令牌 管理令牌 令牌列表会显示每个令牌的名称、前缀(令牌开头字符)、权限、状态,以及创建时间和最近使用时间。
双击令牌可查看详情。 Revoke 会禁用令牌。使用它的客户端会被断开连接,但令牌仍会留在列表中,状态为 Revoked。 Delete 会把令牌从列表中移除。使用它的客户端会被断开连接。
令牌保存在 macOS Keychain 中。TablePlus 自动为 tableplus-mcp 生成的令牌不会出现在列表里。 客户端能做什么 客户端可以使用以下工具:
工具 说明
list_connections 列出该令牌有权访问的已保存连接。
list_open_connections 列出 TablePlus 中已打开的连接。
open_connection 打开一个已保存的连接,可以在标签页或新窗口中打开。
disconnect 关闭某个连接或其中的某个数据库。
execute_read_query 执行只读语句或脚本。
execute_query 执行任意语句或脚本,需要 Read & Write 或 Full Access 权限。
查询最长可运行 300 秒。查询在连接的工作区中执行,因此会出现在该连接的控制台日志里。 客户端还可以读取你保存的查询、各连接的查询历史,以及指标看板。如果许可所有者关闭了查询历史,则无法读取。 查询审批 MCP 客户端可能会在工具执行前向你确认。TablePlus 会把 execute_read_query 标记为只读,把 execute_query 标记为可修改数据的工具,因此像 Claude 这样的客户端会要求你批准每次 execute_query 调用,除非你已关闭它的审批提示。并非所有客户端都会询问。 无论客户端如何设置,TablePlus 都会对修改数据或结构的查询进行确认:
对处于 Silent Mode 的连接,当 Approval needed for unsafe query 开启时,TablePlus 会在 Approve AI Agent Query 弹窗中显示该查询。点击 Allow 执行,或点击 Deny 拒绝。 对处于其他安全模式的连接,由安全模式本身进行确认,你需要确认查询或输入数据库密码。
当 TablePlus 需要你确认查询时,它会自动切换到前台。 如果关闭 Approval needed for unsafe query,拥有 Read & Write 权限的令牌可以在 Silent Mode 连接上修改数据,而无需 TablePlus 确认。建议使用 Read Only 令牌,或把令牌限制在所需的连接上,以防止客户端修改数据。
Activity 点击 Settings > MCP 中的 Activity,或在 Open Anything 中选择 MCP Activity,打开 Integrations Activity 窗口。 MCP 活动日志 使用工具栏中的 View 控件切换:
Activity:所有请求的日志,包含状态、时间、类别、令牌、客户端地址、连接、操作和查询。选中一行可查看详情。可通过搜索框、时间范围(Last 24 hours、Last 7 days、Last 30 days、All time)和令牌菜单筛选日志。点击 Export CSV 导出日志,或点击 Clear Activity 删除 30 天或 7 天前的条目,或全部删除。 Client:当前已连接的客户端,显示名称、版本、令牌、地址以及连接时间和最近活跃时间。选中客户端并点击 Disconnect 可结束其会话并取消其正在运行的请求。
远程访问 要让其他机器上的 MCP 客户端连接:
勾选 Allow remote access (TLS)。服务器将改用 HTTPS。 点击 Export Certificate…,在远程机器上把 tableplus-mcp.pem 安装为受信任的证书。 为远程客户端创建访问令牌。 在 Client Setup 下点击 Manual Setup… 并选择 HTTP Server 查看端点地址,例如 https://your-mac.local:51003/mcp。在客户端中使用该地址和令牌。
远程客户端可以访问其令牌允许的所有连接。请给远程客户端分配权限最低的令牌,并限制在特定连接上使用。