mcp-server-tidb

mcp-server-tidb

TiDB（サーバーレス）データベース向けの MCP サーバー実装です。

前提条件

• uv（Python パッケージインストーラー）

インストール

# Clone the repository
git clone https://github.com/c4pt0r/mcp-server-tidb
cd mcp-server-tidb

# Install the package and dependencies using uv
uv venv
uv pip install -e .

設定

無料の TiDB データベースクラスターを作成するには、tidbcloud.com にアクセスしてください。

設定は環境変数または .env を使用して指定できます。

• TIDB_HOST - TiDB のホストアドレス。例：'gateway01.us-east-1.prod.aws.tidbcloud.com'
• TIDB_PORT - TiDB のポート（デフォルト：4000）
• TIDB_USERNAME - データベースのユーザー名。例： 'xxxxxxxxxx.<username>'
• TIDB_PASSWORD - データベースのパスワード
• TIDB_DATABASE - データベース名。デフォルトは test です。

Claude Desktop で実行する

Claude Desktop を設定します。手順

claude_desktop_config.json：

{
  "mcpServers": {
      "tidb": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/mcp-server-tidb",
              "run",
              "src/main.py"
          ]
      }
  }
}

WSL で mcp-server-tidb を実行している場合、claude_desktop_config.json は次のようになります。

{
  "mcpServers": {
    "tool-with-env-vars": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "/path/to/uv --directory /path/to/mcp-server-tidb run python src/main.py"
      ]
    }
  }
}