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以上がインストールされていること。
uvがインストールされていること。
MCP をサポートする AI 開発ツール:
AIツールに接続する
TiDB CloudでTiDB Cloud Starter クラスターを作成したら、次の手順を実行してそれを AI ツールに接続します。
My TiDBページで、ターゲットクラスターの名前をクリックして概要ページに移動します。次に、右上隅のUse with AI Toolsをクリックします。
Access
your_cluster_namewith AI toolsダイアログで、AI ツールがアクセスするBranchとDatabaseを選択します。記載されているすべてのPrerequisitesを満たしていることを確認してください。満たしていない場合は、画面の指示に従って必要な依存関係をインストールしてください。
パスワードを設定します。
まだパスワードを設定していない場合は、 Generate Passwordをクリックしてランダムなパスワードを生成します。
生成されたパスワードは再度表示されないため、パスワードは安全な場所に保存してください。
すでにパスワードを設定している場合は、 Enter the password for easy setupフィールドにパスワードを入力します。
パスワードを忘れた場合は、 PrerequisitesセクションのReset passwordをクリックして、新しいパスワードを生成します。
パスワードをリセットすると、既存のすべての root ユーザー セッションが切断されることに注意してください。
AI ツールのタブを選択します: Cursor 、 Claude Code 、 VS Code 、またはWindsurf 。
選択したツールのセットアップ手順を完了します。
詳細についてはツール固有の設定を参照してください。
ツール固有の設定
Cursor
Cursor を TiDB の MCP クライアントとして構成するには、次のいずれかの方法を使用できます。
方法 1 : TiDB CloudコンソールのAccess
your_cluster_namewith AI toolsダイアログで、Add to CursorをクリックしてCursorを起動し、Installをクリックします。方法 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
Claude Code を TiDB の MCP クライアントとして構成するには、次のいずれかの方法を使用できます。
方法 1 : TiDB CloudコンソールのAccess
your_cluster_namewith AI toolsダイアログからセットアップ コマンドをコピーし、ターミナルで実行します。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ファイルに以下の設定を追加します。詳細については、 Claude Codeのドキュメントを参照してください。{ "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 Code
VS Code を TiDB の MCP クライアントとして構成するには、次のいずれかの方法を使用できます。
方法 1 : TiDB CloudコンソールのAccess
your_cluster_namewith AI toolsダイアログで、 Add to VS Codeをクリックして VS Code を起動し、 Installをクリックします。方法 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>" } } } }
Windsurf
TiDB MCPプラグインをWindsurfに追加するには、 mcp_config.jsonファイルを以下のように更新してください。詳細については、 Windsurfのドキュメントを参照してください。
{
"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>"
}
}
}
}