quorum

Quorum MCP 服务

通过 Quorum，让 Claude、Cursor、VS Code、Windsurf、Codex 或你自己的 Agent 访问你的数据库，并遵循与 Quorum 编辑器相同的规则：只读会话、数据遮蔽，以及每次写入都需由人员批准。

• 网站：https://www.quorumdb.ai/mcp
• 指南：如何通过 MCP 安全地将 Claude、OpenAI 或 Cursor 连接到你的数据库

目录

• 工作原理
• 要求
• 设置 AI 客户端
• 选择 AI 客户端可以使用的连接
• 工具
• 如何处理写入
• Quorum Gate
• quorum 命令
• 关于此仓库

工作原理

MCP（Model Context Protocol）是 AI 工具调用外部工具的方式。Quorum 提供一个 MCP 服务，由 AI 客户端在其端启动。该服务通过你电脑上的本地桥接程序与正在运行的 Quorum 应用通信。

• 必须打开 Quorum。 只有在 Quorum 运行时，AI 客户端才能访问你的数据库。
• 密码不会离开 Quorum。 客户端发送请求；Quorum 使用自己保存的登录信息执行请求。
• 每个连接对 AI 客户端默认关闭，需由你开启。
• 遵循与编辑器相同的规则： 读取使用只读会话，并进行数据遮蔽；写入需要批准。

读取操作在只读会话中执行，最多返回 10,000 行。被遮蔽的列返回时仍会被遮蔽，引用被遮蔽列的查询会被拒绝。对于 DuckDB 和 SQLite，AI 客户端无法读取或写入你电脑上的文件。

要求

• macOS、Windows 或 Linux 上的 Quorum 桌面应用，版本为 4.0.0 或更高。Quorum 是一款付费产品，免费 14 天试用即将推出；请访问 https://www.quorumdb.ai/#access 申请访问，以便优先获知相关消息。
• MCP 客户端。Quorum 会为你设置 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 和 Codex，并提供可复制到其他客户端的配置。

服务运行在 Quorum 内置的 Node 运行时上，因此无需安装其他内容。

设置 AI 客户端

1. 在 Quorum 中，打开 Settings › AI clients。
2. 在 1. AI clients 下找到该客户端。其状态为 Set up、Not set up、Not found 或 Set up for another copy。
3. 点击 Set up。Quorum 会将相关条目添加到客户端自己的配置文件中，并保留文件中的其他内容。
4. 退出客户端，然后重新打开。
5. 在 2. Connections the AI may use 下，开启它应当能够访问的连接。

对于其他客户端，打开 Another AI client: copy the config，点击 Copy，然后将配置粘贴到该客户端的 MCP 设置中。

客户端	Quorum 写入的配置文件（macOS）
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code	~/.claude.json
Cursor	~/.cursor/mcp.json
VS Code	~/Library/Application Support/Code/User/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Codex	~/.codex/config.toml，或 CODEX_HOME 中的文件夹

Claude Desktop 和 VS Code 对应的配置文件在 Linux 上位于 ~/.config，在 Windows 上位于 %APPDATA%。

选择 AI 客户端可以使用的连接

在你共享连接之前，AI 客户端看不到任何连接。在 Settings › AI clients 中，点击 Choose connections…，按环境搜索或浏览，然后为每个连接开启 Let AI clients use。

• 只有在 Allow AI features on this connection 开启时，共享的连接才可读取。
• 如果 AI may see row values 处于关闭状态，返回给客户端的将是各列的概要，而不是列值。
• 导入和共享的连接对 AI 客户端始终默认为关闭。

工具

工具	功能
quorum_list_connections	列出共享连接及其写入处理方式。
quorum_get_schema	读取连接的架构：表、视图、列、类型和键。
quorum_describe_table	描述某个表，包含团队提供的描述。
quorum_search_schema	按名称查找表和列。
quorum_sample_rows	读取表中最多 100 行。屏蔽列会以屏蔽状态返回。
quorum_explain_query	显示单次读取的执行计划。仅运行 EXPLAIN，不会执行查询。
quorum_execute_query	在只读会话中运行读取操作；如果写入设置允许，也可运行写入操作。
quorum_list_saved_queries	列出团队保存的查询。
quorum_run_saved_query	以读取操作的方式运行已保存的查询。
quorum_get_query_history	读取共享连接的查询历史记录。
quorum_get_audit_log	读取写入审计记录：执行人、操作、风险和受影响的行数。
quorum_get_data_dictionary	读取团队对表和列的描述。
quorum_get_service_health	如果已在 Quorum 中设置，则读取来自 Last9 或 Datadog 的服务健康状况。
quorum_propose_write	提交一项写入提议，并附上原因，供人员在 Quorum 中审批。
quorum_get_proposal	检查提议的处理结果。
quorum_list_proposals	列出最近的提议及其状态。

写入处理方式

Settings › AI clients › 3. Writes from AI clients 有两个选项：

选项	处理方式
Ask me in Quorum（默认，推荐）	写入操作会在 Quorum 中等待，直到你批准。在 PROD 上还需要输入 PROD。
Run allowed writes directly	在 LOCAL、DEV、QA、UAT 和 STAGE 上，允许的数据更改会立即执行。PROD 上的写入会被拒绝。

即使写入会直接执行，Quorum 仍会拒绝任何在 PROD 上的写入和任何高风险写入；拒绝在除 LOCAL 之外的任何连接上执行 DDL 和 TRUNCATE；拒绝在只读、始终需要审核、需要工单或设有冷却时间的连接上写入；并拒绝任何被安全检查拦截的操作，例如不带 WHERE 的 UPDATE。每项写入和每次拒绝都会记录在写入审计中，执行者标记为 AI Agent。

Quorum Gate

使用 Ask me in Quorum 时，AI 客户端会附上一行原因，提交写入提议，Quorum 随后等待你的处理。

1. Quorum 会显示请求信息：类型、环境、连接、风险和客户端给出的原因，然后显示格式化后的 SQL。
2. What it will change 会显示受影响的行数、设置的列、值是否实际发生变化，以及一些匹配行的示例（屏蔽列会保持屏蔽状态）。
3. 如果系统要求，请输入确认词（例如 PROD）和工单。
4. 点击 Approve and run once，或输入原因并点击 Reject。客户端会看到你的原因。

获批的写入会严格按照提议内容执行一次，并经过与编辑器相同的检查。请求会在 30 分钟后过期。没有响应就不会执行写入。

在支持 MCP Apps 的客户端中，例如 Claude、Claude Desktop、VS Code、Cursor 和 Goose，请求也会以卡片形式显示在聊天中。卡片会显示状态；审批操作在 Quorum 中进行。

quorum 命令

同一桥接程序也支持命令行工具，可通过正在运行的 Quorum 应用及其规则运行查询。请从 Settings › AI clients › Command-line tool 安装。

quorum connections
quorum query <connection> "<sql>" [--format table|csv|json] [--limit N]
quorum describe <connection> <table> [--schema S]
quorum saved
quorum run-saved "<name>" [--connection C] [--format …]
quorum history [--connection C] [--limit N]
quorum propose <connection> "<sql>" --reason "<why>" [--wait SECONDS]
quorum request <id> [--wait SECONDS]

只有与 AI 客户端共享的连接才能访问。写入操作会通过 propose 提交，并等待在 Quorum 中审批。

关于此代码仓库

此代码仓库用于说明 Quorum 的 MCP 服务，并包含其 MCP Registry 条目（server.json）。服务本身随 Quorum 应用一起发布。问题反馈：https://www.quorumdb.ai/#contact。

产品和公司名称是各自所有者的商标，仅用于描述 Quorum 可与哪些产品和公司协同工作。