McpMux
Back to Registry

TiDB (uvx) MCP Server

Community

Contributed by PingCAP

Connect to a TiDB or TiDB Cloud database. List databases and tables, run read-only queries, execute data-modifying SQL, and manage database users.

About the TiDB (uvx) MCP Server

The TiDB (uvx) MCP server is a local (stdio) Model Context Protocol server available in the McpMux registry. Connect to a TiDB or TiDB Cloud database. List databases and tables, run read-only queries, execute data-modifying SQL, and manage database users. This is a community-contributed MCP server by PingCAP.

Install the TiDB (uvx) MCP server with one click using McpMux. It works with Cursor, Claude Desktop, Claude Code, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible AI client. This server requires an API key — McpMux securely stores your credentials with AES-256-GCM encryption.

Transport Configuration

Transport Configuration
{
  "type": "stdio",
  "command": "uvx",
  "args": [
    "--from",
    "pytidb[mcp]",
    "tidb-mcp-server"
  ],
  "env": {
    "TIDB_HOST": "${input:TIDB_HOST}",
    "TIDB_PORT": "${input:TIDB_PORT}",
    "TIDB_USERNAME": "${input:TIDB_USERNAME}",
    "TIDB_PASSWORD": "${input:TIDB_PASSWORD}",
    "TIDB_DATABASE": "${input:TIDB_DATABASE}"
  },
  "metadata": {
    "inputs": [
      {
        "id": "TIDB_HOST",
        "label": "TiDB Host",
        "description": "Hostname of your TiDB server. For TiDB Cloud, use the gateway host shown in the connection dialog.",
        "type": "text",
        "required": true,
        "secret": false,
        "placeholder": "gateway01.xxx.prod.aws.tidbcloud.com"
      },
      {
        "id": "TIDB_PORT",
        "label": "TiDB Port",
        "description": "Port of your TiDB server. Defaults to 4000.",
        "type": "number",
        "required": false,
        "secret": false,
        "default": "4000",
        "placeholder": "4000"
      },
      {
        "id": "TIDB_USERNAME",
        "label": "TiDB Username",
        "description": "Database username. For TiDB Cloud this looks like '<prefix>.root'.",
        "type": "text",
        "required": true,
        "secret": false,
        "placeholder": "xxxxxxxx.root"
      },
      {
        "id": "TIDB_PASSWORD",
        "label": "TiDB Password",
        "description": "Password for the TiDB user.",
        "type": "text",
        "required": true,
        "secret": true,
        "placeholder": "********************"
      },
      {
        "id": "TIDB_DATABASE",
        "label": "TiDB Database",
        "description": "Default database to connect to. Defaults to 'test'.",
        "type": "text",
        "required": true,
        "secret": false,
        "default": "test",
        "placeholder": "test"
      }
    ]
  }
}
Details
TransportLocal (stdio)
Hostinglocal
AuthAPI Key
Capabilities
Tools

Categories

Tags

tidbtidb-clouddatabasesqlmysqlpingcap

Supported AI Clients

The TiDB (uvx) MCP server works with all MCP-compatible AI clients through McpMux:

CursorClaude DesktopClaude CodeVS CodeChatGPTWindsurfJetBrainsZedClineGemini CLIAmazon Q

Related MCP Servers

Install TiDB (uvx) with McpMux

One-click install from the McpMux desktop app. Auto-configures for Cursor, Claude, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible client.