TiDB

Un servidor MCP para TiDB, una base de datos SQL distribuida y sin servidor.

Documentación

mcp-server-tidb

Implementación del servidor MCP para la base de datos TiDB (serverless).

Requisitos previos

  • uv (instalador de paquetes de Python)

Instalación

# 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 .

Configuración

Visita tidbcloud.com para crear un clúster de base de datos TiDB gratuito.

La configuración se puede proporcionar mediante variables de entorno o usando un archivo .env:

  • TIDB_HOST - Dirección del host de TiDB, p. ej., 'gateway01.us-east-1.prod.aws.tidbcloud.com'
  • TIDB_PORT - Puerto de TiDB (predeterminado: 4000)
  • TIDB_USERNAME - Nombre de usuario de la base de datos, p. ej., 'xxxxxxxxxx.<username>'
  • TIDB_PASSWORD - Contraseña de la base de datos
  • TIDB_DATABASE - Nombre de la base de datos, el predeterminado es test

Ejecutar con Claude Desktop

Configura Claude Desktop, CÓMO

claude_desktop_config.json:

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

Si estás ejecutando mcp-server-tidb en WSL, el claude_desktop_config.json debería verse así:

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