CockroachDB MCP Server 是一个自然语言接口，专为 LLM 和智能体应用设计，用于管理、监控和查询 CockroachDB 中的数据。它可与 MCP（Model Content Protocol）客户端无缝集成，例如 Claude Desktop 或 Cursor，使 AI 驱动的工作流能够直接与数据库交互。
用途方面，该服务器将 CockroachDB 暴露为一组 MCP 工具。请求从任意 MCP 客户端出发，经过传输层进入安全层，然后分发到十三类工具之一，最终通过 asyncpg 连接池到达 CockroachDB。
主要能力分为十三类工具：集群监控（获取集群健康与节点状态、查看运行中查询、分析查询性能、复制与分布状态、慢查询、事务洞察、争用事件、索引建议）；数据库操作（连接数据库、列出/创建/删除/切换数据库、连接状态与会话、数据库设置）；表管理（创建/删除/描述/重命名/截断表，增删改列，批量导入 CSV/Avro，索引与视图管理，schema 管理，列出表及关系）；查询引擎（执行带 JSON/CSV/表格式输出的 SQL、多语句事务、解释查询计划、查询历史）；用户与权限管理（用户/角色/权限的增删改查，权限按允许列表校验）；向量搜索（使用 cosine/L2/内积进行相似度搜索，管理 C-SPANN ANN 索引，需 v25.2+）；任务管理（观察和控制 BACKUP、RESTORE、IMPORT、CHANGEFEED、SCHEMA CHANGE 等异步任务）；备份与恢复（集群/数据库/表级备份与恢复，支持 s3、gs、azure、nodelocal、userfile）；统计信息（创建与展示优化器统计）；多区域（区域、存活目标、表局部性、区域配置）；变更数据流（到 Kafka、webhook、云存储的 CDC 管道）；集群管理（集群设置、节点下线/排空）；诊断（追踪跨度、语句诊断包）。
使用方式上，可通过 uvx 快速启动（推荐使用 tagged release，主分支处于活跃开发中可能包含破坏性变更），也支持开发安装、Docker 部署，以及作为 MCPB 包（Smithery / Claude Desktop）安装。配置方式有两种：命令行参数或环境变量，优先级为 CLI 参数 > 环境变量 > 默认值。命令行选项包括 --url、--host、--port、--db、--username、--password、--ssl-mode、--ssl-key、--ssl-cert、--ssl-ca-cert、--transport、--http-host、--http-port、--http-path、--stateless-http、--use-env、--read-only、--allow-destructive、--version。支持 stdio（默认）和 streamable HTTP 传输。可集成 OpenAI Agents SDK、Augment、Claude Desktop、VS Code with GitHub Copilot、Cursor 等。
适用场景包括：让 AI 智能体以自然语言查询和操作 CockroachDB、数据库监控与运维、向量相似度检索、备份恢复、CDC 管道管理、多区域配置等。
限制与安全方面：该服务器面向 LLM 驱动的智能体，提示注入可能转化为 SQL 注入或数据破坏，因此内置三层防御。所有数据库、schema、表、列、索引、视图名称在拼入 SQL 前会以 ^[A-Za-z_][A-Za-z0-9_]{0,62}$ 校验；取值一律参数化，使用 asyncpg 占位符；服务级策略上，--read-only 会禁用所有 DDL 和写入型工具，--allow-destructive 是 drop_* 工具的必要前提，且每次调用仍须传入 confirm=True；DSN 在响应中会被脱敏，密码不会出现在 connect() 结果中。生产环境助手类用法推荐默认 --read-only。向量搜索需 CockroachDB v25.2+。SQL 发起的节点下线仅标记意图，完整生命周期需使用 cockroach node CLI。
