开始使用 Claude Desktop 和 TiDB MCP Server

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

前置条件

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

• Claude Desktop：从 claude.ai 下载并安装 Claude Desktop。
• Python (>=3.10) 和 uv：确保已安装 Python（3.10 或更高版本）和 uv。请按照 安装指南 安装 uv。
• TiDB Cloud Starter 集群：你可以在 TiDB Cloud 上创建一个免费的 TiDB 集群。

设置步骤

按照以下步骤在 Claude Desktop 中设置 TiDB MCP Server：

1. 打开 Settings 对话框。

2. 在对话框中点击 Developers 标签页。

3. 点击 Edit Config 按钮，打开 MCP 配置文件 claude_desktop_config.json。

4. 将以下配置复制到 claude_desktop_config.json 文件中。

   {
     "mcpServers": {
       "TiDB": {
         "command": "uvx --from pytidb[mcp] tidb-mcp-server",
         "env": {
           "TIDB_HOST": "localhost",
           "TIDB_PORT": "4000",
           "TIDB_USERNAME": "root",
           "TIDB_PASSWORD": "",
           "TIDB_DATABASE": "test"
         }
       }
     }
   }
   

5. 前往 TiDB Cloud 集群页面，并导航到你想要连接的集群。

6. 点击右上角的 Connect，获取连接参数，并将 TIDB_HOST、TIDB_PORT、TIDB_USERNAME、TIDB_PASSWORD 和 TIDB_DATABASE 的值替换为你自己的。

7. 重启 Claude Desktop。

如需了解更多详情，请参阅 如何在 Claude Desktop 中配置 MCP server。