大网数据广告活动
数据库部署与 SQL 参考

开始使用 Windsurf 和 TiDB MCP Server

· 52CE 我爱测

1. 在 **My TiDB** 页面上,点击目标 {{{ .starter }}} 实例的名称进入其概览页面,然后点击右上角的 **Use with AI Tools**。 2. 在显示的对话框中,选择 Windsurf 需要访问的 **Branch** 和 **Database**。 3. 查看对话框中的 **Prerequisites** 列表,并安装任何缺失的依赖项。 4. 配置 root 密码:

开始使用 Windsurf 和 TiDB MCP Server

本指南将介绍如何在 Windsurf 中配置 TiDB MCP Server。

前置条件

在开始之前,请确保你已具备以下条件:

  • Windsurf:从 windsurf.com 下载并安装 Windsurf。
  • Python (>=3.10) 和 uv:确保已安装 Python(3.10 或更高版本)和 uv。请按照 安装指南 安装 uv。
  • 一个 {{{ .starter }}} 实例:你可以在 TiDB Cloud 上创建一个免费的 {{{ .starter }}} 实例。

连接到 TiDB Cloud Starter(推荐)

使用 TiDB Cloud 控制台收集连接信息,然后更新 Windsurf 的 MCP 配置。

  1. 在 My TiDB 页面上,点击目标 {{{ .starter }}} 实例的名称进入其概览页面,然后点击右上角的 Use with AI Tools。

  2. 在显示的对话框中,选择 Windsurf 需要访问的 Branch 和 Database。

  3. 查看对话框中的 Prerequisites 列表,并安装任何缺失的依赖项。

  4. 配置 root 密码:

    • 如果你尚未设置密码,点击 Generate Password 并将其保存在安全的位置(该密码只会显示一次)。
    • 如果已存在密码,在 Enter the password for easy setup 字段中输入该密码。
    • 如果忘记了密码,在 Prerequisites 部分点击 Reset password 以生成新密码。
  5. 选择 Windsurf 标签页,并复制提供的连接参数。

  6. 使用复制的参数更新你的 mcp_config.json 文件。更多信息请参见 Windsurf MCP 文档。

手动配置(任意 TiDB 集群)

如果你更倾向于手动配置,请按如下方式更新你的 mcp_config.json 文件,并将占位符替换为你的连接参数:

{
  "mcpServers": {
    "TiDB": {
      "command": "uvx",
      "args": ["--from", "pytidb[mcp]", "tidb-mcp-server"],
      "env": {
        "TIDB_HOST": "<YOUR_TIDB_HOST>",
        "TIDB_PORT": "<YOUR_TIDB_PORT>",
        "TIDB_USERNAME": "<YOUR_TIDB_USERNAME>",
        "TIDB_PASSWORD": "<YOUR_TIDB_PASSWORD>",
        "TIDB_DATABASE": "<YOUR_TIDB_DATABASE>"
      }
    }
  }
}

另请参阅

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。