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