Schemity MCP Server已验证已精选

什么是 Schemity MCP Server？

Schemity MCP Server 是内置于桌面数据库设计应用 Schemity 中的本地数据库 MCP 服务器。你的智能体通过 Schemity 中打开的图表读取 PostgreSQL、MySQL、MariaDB、SQL Server 或 SQLite 数据库的结构，在迁移运行前检查它会造成什么影响，并暂存供你审核的修改。

大多数数据库 MCP 服务器会把连接字符串交给智能体，并执行它写出的任何 SQL。Schemity 的做法正好相反：智能体通过 Schemity 从你的数据库读取的图表工作，永远拿不到数据库凭据，它所做的任何事都不会写入数据库。读取不会改变任何内容，修改以未保存更改的形式出现在图表中，只有当你自己运行迁移时才会触及数据库。该服务器随闭源桌面应用一起发布；GitHub 仓库 tbson/schemity-mcp 存放其文档、tools.json 和示例主机配置。

如何使用 Schemity MCP Server？

1. 在 macOS、Windows 或 Linux 上安装 Schemity。
2. 打开你希望智能体看到的图表。服务器只能看到 Schemity 窗口中打开的图表，而不是磁盘上的文件。
3. 通过控制栏上的插头图标打开 MCP 面板，或按 Cmd+Shift+A（macOS）/ Ctrl+Shift+A（Windows、Linux）。面板会显示服务器状态、连接测试，以及为每个主机准备的、带有适合你平台路径的配置片段。

以下示例使用 macOS 路径。在 Windows 和 Linux 上，请从 MCP 面板复制配置片段。

主机有两种连接方式。stdio 主机使用 --mcp 启动 Schemity 可执行文件，因此在 Schemity 关闭时也能启动它。HTTP 主机使用面板中的 bearer token 连接 http://127.0.0.1:7332/mcp，此时 Schemity 必须已经打开。

Claude Code

claude mcp add --scope user schemity -- "/Applications/Schemity.app/Contents/MacOS/schemity" --mcp

如果你之前用旧的 HTTP 命令注册过 Claude Code，请先运行 claude mcp remove --scope user schemity。

Claude Desktop

把以下内容添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "schemity": {
      "command": "/Applications/Schemity.app/Contents/MacOS/schemity",
      "args": ["--mcp"]
    }
  }
}

Cursor

保持 Schemity 打开。在 ~/.cursor/mcp.json 中添加以下内容，token 从 MCP 面板复制：

{
  "mcpServers": {
    "schemity": {
      "url": "http://127.0.0.1:7332/mcp",
      "headers": { "Authorization": "Bearer <token from the MCP panel>" }
    }
  }
}

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.schemity]
command = "/Applications/Schemity.app/Contents/MacOS/schemity"
args = ["--mcp"]

OpenCode 在 opencode.json 中使用 local 条目，命令相同并带 --mcp。

Schemity MCP Server 的主要功能

• 支持 PostgreSQL、Supabase、MySQL、MariaDB、SQL Server 和 SQLite，可直接连接或通过 SSH 隧道连接。
• 智能体永远拿不到数据库凭据。
• 迁移运行前进行影响分析：数据丢失、会在现有行上失败的语句、表重写、大表上的锁，以及依赖的视图和函数。
• 无需运行即可分析手写的或由 Prisma、Alembic、Flyway 生成的迁移文件。
• 智能体的修改以未保存更改的形式暂存，并以智能体的名义记录在撤销历史中。
• 包含删除操作的计划会先询问你，并标明是哪个智能体、列出它想删除的内容。
• 没有厂商云端：HTTP 服务器只监听 127.0.0.1，bearer token 保存在操作系统钥匙串中。

Schemity MCP Server 工具

Schemity 2.11.2 提供 16 个工具。

• 读取工具（不会改变任何内容）：open_schemity 启动应用或将其置于前台；list_diagrams（应首先调用）、get_schema 和 get_context_views 描述打开的图表；get_dependencies 显示某个实体的入向和出向关系；get_data_dictionary 以 Markdown 返回带文档的结构；lint 报告命名规范、缺失索引和类型不匹配问题。
• 迁移影响：get_pending_changes、analyze_impact、analyze_migration_file，以及在你要求时以只读查询执行精确计数的 count_rows。
• 可视化审核：check_relation_lines 查找重叠或交叉的连线；show_preview 在一次性的只读画布上绘制拟议的更改。
• 暂存修改：propose_changes 创建、修改和删除实体、字段、关系、图例和上下文视图；group_entities 将实体分组到图例中；route_relations 重新布线关系线以减少交叉。

Schemity MCP Server 的使用场景

• 合并前的迁移审核：“分析这个 Prisma 迁移文件，告诉我哪些语句会在现有行上失败。”
• 结构探索：“列出图表，然后解释 orders 和 invoices 表之间的关系。”
• 结构设计：“添加一个关联到 users 的 audit_log 表”，然后在 Schemity 中审核暂存的更改并保存或撤销。
• 文档：“把这个图表的数据字典导出为 Markdown。”
• 清理：“运行 lint 并修复它发现的缺失索引。”

Schemity MCP Server 常见问题排查

• “Schemity is not running”：只有 stdio 主机能启动应用。在 Cursor 这类 HTTP 主机上，请自己打开 Schemity 后重试。
• 401 Unauthorized：面板中的 token 已重新生成。把当前 token 复制到主机配置中。
• 端口被占用：在 MCP 面板中选择其他端口并点击 Restart。
• 工具提示某个图表“not open”：在 Schemity 窗口中打开该图表。