用途：SpacetimeDB 主机支持 MCP，MCP 客户端可用工具调用操作运行中的数据库，替代 shell 命令。若客户端暴露 spacetimedb 工具，读取或修改运行中数据库时应优先使用它们。
主要能力：工具为被动注册，包括 spacetimedb.list_databases、spacetimedb.get_schema、spacetimedb.sql、spacetimedb.call、spacetimedb.ping。list_databases 无参数，返回你拥有的数据库及身份与名称；get_schema 接收 database，返回表与 reducer 的 JSON；sql 接收 database、sql 及可选 confirmed，返回行 JSON；call 接收 database、reducer 及可选 args（JSON 数组），返回 reducer 结果；ping 为健康检查。
使用方式：先查看 tools/list 确认工具是否存在。服务器分两种形态：主机级（spacetime mcp 不带数据库，或 POST /v1/mcp）每个数据工具需必填 database 参数，并提供 list_databases；单库级（spacetime mcp <database>，或 POST /v1/database/<db>/mcp）连接已固定数据库，无 database 参数与 list_databases。在含唯一明确服务器的 spacetime.json 项目内运行 spacetime mcp 时会使用该服务器，除非传入 --server 或 --no-config；它不会从配置推断数据库。
适用场景与限制：MCP 工具只能操作已存在的数据库，无法初始化项目、编译模块、发布或生成绑定，这些需用 spacetime CLI（init、build、publish、generate、start、logs），二者互补。工具以你的身份运行，与 HTTP API 一致；reducer 是写入路径，call 在事务中执行，要么全部提交要么全部回滚；SQL 写入需拥有数据库，读取公开表，私有表客户端不可读，get_schema 仍会显示其声明，故 sql 报 no such table 通常意味着表为私有或查错库。工具错误以 isError: true 与文本返回，非传输失败。spacetime mcp 为 UNSTABLE，可能发生破坏性变更；客户端无法启动时应回退到 CLI。参考：https://spacetimedb.com/docs