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

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

前提条件

始める前に、以下のものを用意してください。

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

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

TiDB Cloudコンソールを使用して接続の詳細を取得し、WindsurfのMCP構成を更新してください。

1. 私のTiDBページで、対象のTiDB Cloud Starterインスタンスの名前をクリックして概要ページに移動し、右上隅の[AI ツールで使用する]をクリックします。

2. 表示されたダイアログで、Windsurfがアクセスするブランチとデータベースを選択します。

3. ダイアログに表示される前提条件リストを確認し、不足している依存関係があればインストールしてください。

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

   • まだパスワードを設定していない場合は、「パスワードを生成」をクリックして、生成されたパスワードを安全な場所に保存してください（パスワードは一度しか表示されません）。
   • パスワードが既に存在する場合は、 「簡単なセットアップのためのパスワードを入力してください」欄に入力してください。
   • パスワードを忘れた場合は、 「前提条件」セクションの「パスワードのリセット」をクリックして新しいパスワードを生成してください。

5. 「ウィンドサーフィン」タブを選択し、表示された接続値をコピーしてください。

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サーバー