WindsurfとTiDB MCPサーバーを使い始める

このガイドでは、Windsurf で TiDB MCP サーバーを構成する方法を説明します。

前提条件

始める前に、次のものがあることを確認してください。

• Windsurf : ウィンドサーフィン.comから Windsurf をダウンロードしてインストールします。
• Python (>=3.10) と uv : Python (3.10以降) とuvインストールされていることを確認してください。4 インストールガイド手順に従ってuvインストールしてください。
• TiDB Cloud Starter クラスター: TiDB Cloudに無料の TiDB クラスターを作成できます。

TiDB Cloud Starterに接続する（推奨）

TiDB Cloudコンソールを使用して接続の詳細を収集し、Windsurf の MCP 構成を更新します。

1. クラスターページに移動し、クラスターを選択して、右上隅の[AI ツールで使用]をクリックします。

2. AI ツールを使用してyour_cluster_nameにアクセスダイアログで、Windsurf がアクセスするブランチとデータベースを選択します。

3. ダイアログの前提条件リストを確認し、不足している依存関係をインストールします。

4. ルートパスワードを設定します。

   • まだパスワードを設定していない場合は、 「パスワードの生成」をクリックして、安全な場所に保存します (1 回だけ表示されます)。
   • パスワードがすでに存在する場合は、 「簡単セットアップ用のパスワードを入力」フィールドに入力します。
   • パスワードを忘れた場合は、 「前提条件」セクションの「パスワードのリセット」をクリックして、新しいパスワードを生成します。

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

参照

• TiDB MCP サーバー