Claude CodeとTiDB MCP Serverを使い始める

このガイドでは、Claude Code で TiDB MCP サーバーを構成する方法を説明します。

前提条件

始める前に、次のものがあることを確認してください。

Claude Code : claude.comからインストールします。
Python (>=3.10) と uv : Python (3.10以降) とuvインストールされていることを確認してください。4 インストールガイド手順に従ってuvインストールしてください。
TiDB Cloud Starter クラスター: TiDB Cloudに無料の TiDB クラスターを作成できます。

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

TiDB Cloudコンソールを使用して、すぐに実行できる Claude Code コマンドを生成します。

クラスターページに移動し、クラスターを選択して、右上隅の[AI ツールで使用]をクリックします。
AI ツールを使用してyour_cluster_nameにアクセスダイアログで、Claude Code がアクセスするブランチとデータベースを選択します。
ダイアログの前提条件リストを確認し、不足している依存関係をインストールします。
ルートパスワードを設定します。
- まだパスワードを設定していない場合は、 「パスワードの生成」をクリックして、安全な場所に保存します (1 回だけ表示されます)。
- パスワードがすでに存在する場合は、 「簡単セットアップ用のパスワードを入力」フィールドに入力します。
- パスワードを忘れた場合は、 「前提条件」セクションの「パスワードのリセット」をクリックして、新しいパスワードを生成します。
Claude コードタブを選択し、セットアップコマンドをコピーして、ターミナルで実行します。

手動構成（任意の TiDB クラスター）

手動でセットアップする場合は、次のいずれかの方法を使用し、プレースホルダーを接続パラメータに置き換えます。

方法1: CLIコマンド

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 MCP ドキュメントをご覧ください。

{
  "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 サーバー