カーソルと TiDB MCP サーバーを使い始める
このガイドでは、カーソル エディターで TiDB MCP サーバーを構成する方法を説明します。
ワンクリックでインストールするには、次のボタンをクリックしてください。
前提条件
始める前に、次のものがあることを確認してください。
- カーソル: カーソル.comからカーソルをダウンロードしてインストールします。
- Python (>=3.10) と uv : Python (3.10以降) と
uvインストールされていることを確認してください。4 インストールガイド手順に従ってuvインストールしてください。 - TiDB Cloud Starter クラスター: TiDB Cloudに無料の TiDB クラスターを作成できます。
TiDB Cloud Starterに接続する（推奨）
TiDB Cloudコンソールを使用して、クラスター資格情報でカーソル構成を作成します。
クラスターページに移動し、クラスターを選択して、右上隅の[AI ツールで使用]をクリックします。
AI ツールを使用して
your_cluster_nameにアクセスダイアログで、カーソルがアクセスするブランチとデータベースを選択します。ダイアログの前提条件リストを確認し、不足している依存関係をインストールします。
ルートパスワードを設定します。
- まだパスワードを設定していない場合は、 「パスワードの生成」をクリックして、安全な場所に保存します (1 回だけ表示されます)。
- パスワードがすでに存在する場合は、 「簡単セットアップ用のパスワードを入力」フィールドに入力します。
- パスワードを忘れた場合は、 「前提条件」セクションの「パスワードのリセット」をクリックして、新しいパスワードを生成します。
[カーソル]タブを選択し、 [カーソルに追加]をクリックして、[カーソルに**インストール] を**クリックします。
手動構成（任意の TiDB クラスター）
手動で設定する場合は、次の構成を.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>"
}
}
}
}
詳細についてはモデルコンテキストプロトコルのドキュメントを参照してください。
トラブルシューティング
TiDB MCP サーバーのインストール中に問題が発生した場合は、Cursor の MCP ログを確認してください。
- エディターの上部にあるメイン メニューで[ビュー] > [出力]をクリックします。
- 出力パネルのドロップダウン メニューからMCPを選択します。
[error] Could not start MCP server tidb-mcp-server: Error: spawn uvx ENOENTようなエラーが表示された場合は、システムの$PATH環境変数にuvxコマンドが存在しない可能性があります。macOS ユーザーの場合は、brew install uvを実行してuvxインストールできます。