使用 Visual Studio Code 和 TiDB MCP Server 入门

本指南介绍如何在 Visual Studio Code（VS Code）中配置 TiDB MCP Server。

前置条件

在开始之前，请确保你具备以下条件：

• Visual Studio Code：从 code.visualstudio.com 下载并安装 VS Code。
• Python (>=3.10) 和 uv：确保已安装 Python（3.10 或更高版本）和 uv。按照 安装指南 安装 uv。
• 一个 TiDB Cloud Starter 实例：你可以在 TiDB Cloud 上创建一个免费的 TiDB Cloud Starter 实例。

连接到 TiDB Cloud Starter（推荐）

使用 TiDB Cloud 控制台生成 VS Code 配置。

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

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

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

4. 配置 root 密码：

   • 如果你尚未设置密码，点击 Generate Password 并将其保存在安全的位置（该密码只会显示一次）。
   • 如果已存在密码，在 Enter the password for easy setup 字段中输入该密码。
   • 如果忘记了密码，在 Prerequisites 部分点击 Reset password 以生成新密码。

5. 选择 VS Code 标签页，点击 Add to VS Code，然后在 VS Code 中点击 Install。

手动配置（适用于任意 TiDB 集群）

如果你更喜欢手动设置，请将以下配置添加到你的 .vscode/mcp.json 文件中，并将占位符替换为你的连接参数：

{
  "mcpServers": {
    "TiDB": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

另请参阅

• TiDB MCP Server