mcp-server-tidb

View on GitHub

mcp server for tidb

22 stars PythonServers & Infrastructure Updated Aug 14, 2025

Documentation

mcp-server-tidb

MCP server implementation for TiDB (serverless) database.

Prerequisites

uv (Python package installer)

Installation

code

# 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.\'
`TIDB_PASSWORD` - Database password
`TIDB_DATABASE` - Database name, default is test

Run with Claude Desktop

Config Claude Desktop, HOWTO

`claude_desktop_config.json`:

code

{
  "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:

code

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

Frequently asked questions

What is mcp-server-tidb?

mcp-server-tidb is mcp server for tidb

How do I install mcp-server-tidb?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-server-tidb open source?

Yes — it is hosted on GitHub at https://github.com/C4PT0R/mcp-server-tidb and has 22 stars.

Related MCP tools

damn-vulnerable-mcp-server

Damn Vulnerable MCP Server Python-based implementation. Trusted by 1200+ developers. Trusted by 1200+ developers. Trusted by 1200+ developers.

1,209 Python

mysql_mcp_server

A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases Python-based implementation. Trusted by 900+ developers.

964 Python

aimcpmodel-context-protocol+1

supabase-mcp-server

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning...

805 Python

cursormodel-context-protocolsupabase+1