# TiDB

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

- 类型：MCP
- 权限：可执行操作
- 门槛：见接入前准备
- 官方入口：https://docs.pingcap.com/zh/ai/tidb-mcp-claude-desktop/
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/tidb/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

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

## 接入步骤

1. 按官方指引准备 TiDB 实例和最小所需数据库权限；使用 Cloud Starter 时先确认当前免费层限额。 [官方入口](https://docs.pingcap.com/zh/ai/tidb-mcp-claude-desktop/)
2. 按指引安装并配置 MCP，在本地填写数据库地址、端口、用户名与密码；不要把示例值当成可用账号。 [官方入口](https://docs.pingcap.com/zh/ai/tidb-mcp-claude-desktop/)

## 验证方法

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

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

官方接入示例可使用免费的 TiDB Cloud Starter 实例；自建或其他云部署的费用另按实际环境核对。 [官方来源](https://docs.pingcap.com/zh/ai/tidb-mcp-claude-desktop/)（核对日期：2026-11-05）

官方原文：你可以在 TiDB Cloud 上创建一个免费的 TiDB Cloud Starter 实例。

## 安装配置

### JSON

```
{
  "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}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'TIDB_HOST=${TIDB_HOST}' --env 'TIDB_PORT=4000' --env 'TIDB_USERNAME=${TIDB_USERNAME}' --env 'TIDB_PASSWORD=${TIDB_PASSWORD}' --env 'TIDB_DATABASE=${TIDB_DATABASE}' --transport stdio 'tidb' -- 'uvx' '--from' 'pytidb[mcp]' 'tidb-mcp-server'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.tidb]
command = "uvx"
args = ["--from","pytidb[mcp]","tidb-mcp-server"]
env_vars = ["TIDB_HOST","TIDB_USERNAME","TIDB_PASSWORD","TIDB_DATABASE"]

[mcp_servers.tidb.env]
TIDB_PORT = "4000"
```

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

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

## 核验与来源

2026-11-05 核对官方身份：[依据](https://docs.pingcap.com/zh/ai/tidb-mcp-claude-desktop/)。PingCAP 官方中文文档提供 TiDB MCP；使用官方 pytidb 实现，不收个人封装。

官方原文摘录（2026-11-05，来自上述依据）：

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


[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)