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

このガイドでは、カーソルエディタでTiDB MCPサーバーを設定する方法を説明します。

ワンクリックでインストールするには、次のボタンをクリックしてください。

前提条件

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

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

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

TiDB Cloudコンソールを使用して、 TiDB Cloud Starterインスタンスの認証情報でカーソル構成を作成します。

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

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

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

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

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

5. 「カーソル」タブを選択し、 「カーソルに追加」をクリックしてから、「カーソルにインストール」をクリックします。

手動設定（任意の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ログを確認してください。

1. エディタ上部のメインメニューで、 [ビュー] > [出力]をクリックします。
2. 出力パネルのドロップダウンメニューから「MCP」を選択してください。
3. [error] Could not start MCP server tidb-mcp-server: Error: spawn uvx ENOENTのようなエラーが表示される場合は、 uvxコマンドがシステム環境変数$PATHに存在しない可能性があります。macOS ユーザーの場合は、 uvxを実行してbrew install uv 。