TiDB Cloud Starter を AI ツールと併用する

このドキュメントでは、Cursor、Claude Code、Visual Studio Code (VS Code)、Windsurf などのモデルコンテキストプロトコル (MCP) をサポートする AI 搭載開発ツールにTiDB Cloud Starter クラスターを接続する方法について説明します。

TiDB Cloud Starter クラスターを MCPサーバーとして構成すると、開発ツールの AI アシスタントを有効にして、データベーススキーマを照会し、データモデルを理解し、コンテキストに応じたコード提案を生成できるようになります。

始める前に

このガイドを完了するには、次のものが必要です。

TiDB Cloud Starter クラスター。まだお持ちでない場合は、 TiDB Cloud Starterクラスターを作成する実行できます。
Python 3.11以上個インストールされました。
紫外線個インストールされました。
MCP をサポートする AI 開発ツール:

AIツールに接続する

TiDB CloudでTiDB Cloud Starter クラスターを作成したら、次の手順を実行してそれを AI ツールに接続します。

クラスターページ目で、ターゲットクラスターの名前をクリックして概要ページに移動します。次に、右上隅の「AIツールで使用」をクリックします。
AI ツールを使用してyour_cluster_nameにアクセスするダイアログで、AI ツールがアクセスするブランチとデータベースを選択します。
記載されているすべての前提条件を満たしていることを確認してください。満たしていない場合は、画面の指示に従って必要な依存関係をインストールしてください。
パスワードを設定します。
- まだパスワードを設定していない場合は、 「パスワードの生成」をクリックしてランダムなパスワードを生成します。
  生成されたパスワードは再度表示されないため、パスワードは安全な場所に保存してください。
- すでにパスワードを設定している場合は、 「簡単セットアップ用のパスワードを入力」フィールドにパスワードを入力します。
- パスワードを忘れた場合は、 「前提条件」セクションの「パスワードのリセット」をクリックして、新しいパスワードを生成します。
  パスワードをリセットすると、既存のすべての root ユーザーセッションが切断されることに注意してください。
AI ツールのタブを選択します: Cursor 、 Claude Code 、 VS Code 、またはWindsurf 。
選択したツールのセットアップ手順を完了します。
詳細についてはツール固有の設定参照してください。

ツール固有の設定

カーソル

Cursor を TiDB の MCP クライアントとして構成するには、次のいずれかの方法を使用できます。

方法 1 : TiDB CloudコンソールのAI ツールを使用してyour_cluster_nameにアクセスするダイアログで、カーソルに追加をクリックしてカーソルを起動し、インストールをクリックします。

方法 2 : 次の構成を.cursor/mcp.jsonファイルに手動で追加します。

{
  "mcpServers": {
    "TiDB": {
      "command": "uvx --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>"
      }
    }
  }
}

クロード・コード

Claude Code を TiDB の MCP クライアントとして構成するには、次のいずれかの方法を使用できます。

方法 1 : TiDB CloudコンソールのAI ツールでyour_cluster_nameにアクセスするダイアログからセットアップコマンドをコピーし、ターミナルで実行します。

claude mcp add --transport stdio TiDB \
  --env TIDB_HOST='<YOUR_TIDB_HOST>' \
  --env TIDB_PORT=<YOUR_TIDB_PORT> \
  --env TIDB_USERNAME='<YOUR_TIDB_USERNAME>' \
  --env TIDB_PASSWORD='<YOUR_TIDB_PASSWORD>' \
  --env TIDB_DATABASE='<YOUR_TIDB_DATABASE>' \
  -- uvx --from 'pytidb[mcp]' 'tidb-mcp-server'

方法2 ：プロジェクトレベル.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>"
      }
    }
  }
}

VSコード

VS Code を TiDB の MCP クライアントとして構成するには、次のいずれかの方法を使用できます。

方法 1 : TiDB CloudコンソールのAI ツールを使用してyour_cluster_nameにアクセスするダイアログで、 [VS Code に追加]をクリックして VS Code を起動し、 [インストール] をクリックします。

方法 2 : .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プラグインをWindsurfに追加するには、 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>"
      }
    }
  }
}