TiDB

Um servidor MCP para TiDB, um banco de dados SQL distribuído e serverless.

Documentação

mcp-server-tidb

Implementação do servidor MCP para o banco de dados TiDB (serverless).

Pré-requisitos

  • uv (instalador de pacotes Python)

Instalação

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

Configuração

Acesse tidbcloud.com para criar um cluster de banco de dados TiDB gratuito

A configuração pode ser fornecida por meio de variáveis de ambiente ou usando .env:

  • TIDB_HOST - endereço do host TiDB, por exemplo, 'gateway01.us-east-1.prod.aws.tidbcloud.com'
  • TIDB_PORT - porta TiDB (padrão: 4000)
  • TIDB_USERNAME - nome de usuário do banco de dados, por exemplo, 'xxxxxxxxxx.<username>'
  • TIDB_PASSWORD - senha do banco de dados
  • TIDB_DATABASE - nome do banco de dados, o padrão é test

Executar com Claude Desktop

Configure o Claude Desktop, COMO FAZER

claude_desktop_config.json:

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

Se você estiver executando o mcp-server-tidb no WSL, o claude_desktop_config.json deve ficar assim:

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