使用说明
TiDB云零MCP服务器
通过以下方式为任何AI代理提供一个持久的MySQL数据库 模型上下文协议.
零配置 --服务器自动提供免费 TiDB Cloud Zero 首次使用时。没有注册，没有API密钥，没有凭据。运行它。
运作原理
┌─────────────┐ MCP ┌──────────────┐ HTTPS ┌─────────────────┐
│ AI Agent │◄────────────►│ MCP Server │◄────────────►│ TiDB Cloud Zero │
│ (Claude, │ stdio/http │ (this repo) │ /v1beta/sql │ (free MySQL) │
│ Cursor) │ │ │ pure HTTP │ │
└─────────────┘ └──────────────┘ └─────────────────┘
在第一次查询时，服务器调用 POST https://zero.tidbapi.com/v1alpha1/instances 要创建免费数据库，请使用 TiDB无服务器HTTP API 对于所有SQL——纯HTTPS，没有MySQL驱动程序，没有持久连接。
实例凭据在本地缓存(~/.tidb-cloud-zero-mcp/instance.json)并重复使用直至到期。
快速开始
git clone https://github.com/siddontang/tidb-cloud-zero-mcp.git
cd tidb-cloud-zero-mcp
uv run server.py
就是这样。不需要环境变量。第一个查询自动配置数据库。
连接到克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"tidb": {
"command": "uv",
"args": ["run", "--project", "/path/to/tidb-cloud-zero-mcp", "server.py"]
}
}
}
连接到克劳德代码
claude mcp add tidb -- uv run --project /path/to/tidb-cloud-zero-mcp server.py
连接到Cursor/Windsurf
添加到MCP设置中：
{
"tidb": {
"command": "uv",
"args": ["run", "--project", "/path/to/tidb-cloud-zero-mcp", "server.py"]
}
}
HTTP传输
uv run server.py --transport http
# Connect at http://localhost:8000/mcp
自带数据库（可选）
如果您已经有一个TiDB Cloud实例，请设置 TIDB_URL:
export TIDB_URL="mysql://user:password@host/database"
uv run server.py
或单个变量：
export TIDB_HOST="gateway01.us-west-2.prod.aws.tidbcloud.com"
export TIDB_USERNAME="your_user"
export TIDB_PASSWORD="your_password"
export TIDB_DATABASE="test"
工具
| 工具 | 说明 |
|---|---|
query |
运行选择/显示/描述/解释 |
execute |
运行CREATE/INSERT/UPDATE/DELETE/ALTER |
batch_execute |
按顺序运行多个SQL语句 |
list_tables |
列出所有具有行数的表 |
describe_table |
获取表架构 |
get_database_info |
数据库信息、版本和实例状态 |
交互示例
连接后，询问您的AI代理：
- “创建用户表并添加一些示例数据”
- “显示数据库中的所有表”
- “分析订单表中的数据”
- “写一个查询，找到按收入排名前10的客户”
代理使用MCP工具直接与TiDB Cloud Zero交互，无需配置。
建筑
每个SQL查询都是对TiDB的无服务器HTTP API的单个HTTP POST：
POST https://http-{host}/v1beta/sql
Authorization: Basic {base64(user:pass)}
TiDB-Database: {database}
Content-Type: application/json
{"query": "SELECT * FROM users"}
这意味着：
- 没有MySQL驱动程序 --使用HTTPS可在任何地方工作
- 无连接管理 --无状态，每个查询都是独立的
- 边缘兼容 --在无服务器功能和边缘工作者中运行
- 自动配置 -通过Zero API首次使用时创建的数据库
为什么选择TiDB Cloud Zero？
| 特点 | 优点 |
|---|---|
| 零注册 | 没有账户，没有信用卡，就用吧 |
| MySQL兼容 | 适用于所有工具、ORM和语言 |
| 无服务器 | 无需配置，无需维护 |
| HTTP API | 无需驱动程序，纯HTTPS |
| 向量搜索 | 将嵌入与关系数据一起存储 |
| 一次性 | 72小时测试和演示实例 |
发展
uv sync # Install dependencies
uv run mcp dev server.py # Test with MCP Inspector
uv run server.py --transport http # Run HTTP server
许可证
麻省理工学院