Skip to main content
Glama
TiDB MCP Server
by c4pt0r

mcp-server-tidb

MCP server implementation for TiDB (serverless) database.

Prerequisites

  • uv (Python package installer)

Related MCP server: MCP MySQL Server

Installation

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

Configuration

Go tidbcloud.com to create a free TiDB database cluster

Configuration can be provided through environment variables, or using .env:

  • TIDB_HOST - TiDB host address, e.g. 'gateway01.us-east-1.prod.aws.tidbcloud.com'

  • TIDB_PORT - TiDB port (default: 4000)

  • TIDB_USERNAME - Database username, e.g. 'xxxxxxxxxx.<username>'

  • TIDB_PASSWORD - Database password

  • TIDB_DATABASE - Database name, default is test

Run with Claude Desktop

Config Claude Desktop, HOWTO

claude_desktop_config.json:

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

If you're running mcp-server-tidb in WSL, the claude_desktop_config.json should look like this:

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides Claude Desktop with secure access to multiple database connections, allowing users to query MySQL, PostgreSQL, SQLite, and SQL Server databases directly through natural language.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to interact with MySQL databases through secure query execution, schema discovery, and multi-database support with configurable read/write permissions and built-in SQL injection protection.
      82 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude Desktop to execute read-only SQL queries on MySQL databases via natural language, with dynamic connection switching and built-in security.
      3
      162 npm
      7
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables AI agents to interact with a persistent MySQL database through the Model Context Protocol, with automatic provisioning of a free TiDB Cloud Zero instance requiring no signup or configuration.
      6
      2
      -