TiDB

docs.pingcap.com官方已核验

用自然语言查询和修改数据库,管理表结构与数据库用户。

官方文档
类型
MCP
权限
可执行操作
接入门槛
见下方接入前准备
分类
云和开发

本站仅作信息索引,收录不构成背书;使用前请自行核实。使用说明与免责声明

接入方式

接入前准备

需要可访问的 TiDB 实例、连接参数和数据库权限,以及 Python 3.10+、uv。官方示例可用 TiDB Cloud Starter 免费层,该路径需云账号;自建实例的登录和成本另行确认,不能把所有部署标成免费。

按这几步接入

  1. 按官方指引准备 TiDB 实例和最小所需数据库权限;使用 Cloud Starter 时先确认当前免费层限额。 官方入口 ↗
  2. 按指引安装并配置 MCP,在本地填写数据库地址、端口、用户名与密码;不要把示例值当成可用账号。 官方入口 ↗

如何确认成功

先列工具,再查看数据库或表结构,确认连到预期实例。DDL、写入和用户管理应按任务授权执行,不作为连通测试。

接入指引核对日期:2026-11-05

费用

官方接入示例可使用免费的 TiDB Cloud Starter 实例;自建或其他云部署的费用另按实际环境核对。 官方来源 ↗(2026-11-05)

你可以在 TiDB Cloud 上创建一个免费的 TiDB Cloud Starter 实例。
{
  "mcpServers": {
    "tidb": {
      "command": "uvx",
      "args": [
        "--from",
        "pytidb[mcp]",
        "tidb-mcp-server"
      ],
      "env": {
        "TIDB_HOST": "${TIDB_HOST}",
        "TIDB_PORT": "4000",
        "TIDB_USERNAME": "${TIDB_USERNAME}",
        "TIDB_PASSWORD": "${TIDB_PASSWORD}",
        "TIDB_DATABASE": "${TIDB_DATABASE}"
      }
    }
  }
}

JSON 示例用于 Claude Code 的 .mcp.json;${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用,不能将变量名替换成密钥值。

命令会进入 shell 历史,请在本地执行,不要分享。保留命令中的 ${VAR} 引用;Codex 不支持在 URL 或命令参数中展开这些引用,此处保留待本地处理的占位符。

核验

2026-11-05 确认为官方出品,查看依据。PingCAP 官方中文文档提供 TiDB MCP;使用官方 pytidb 实现,不收个人封装。

官方原文摘录(2026-11-05)

"uvx --from pytidb[mcp] tidb-mcp-server"

官方核验仅说明发布者身份,接入是否成功需在你的 Agent 中验证。

收录于 2026-11-04 · 信息有误?报告问题