# c4pt0r/mcp-server-tidb [Health: Active]

**Category:** 🗄️ Databases  
**Repository:** https://github.com/c4pt0r/mcp-server-tidb  
**GitHub Stars:** 24  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/c4pt0r-mcp-server-tidb

## Description
TiDB database integration with schema inspection and query capabilities

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "mcp-server-tidb": {
    "command": "npx",
    "args": ["-y","c4pt0r-mcp-server-tidb"],
    "env": {
      "TIDB_HOST": "",
      "TIDB_PORT": "",
      "TIDB_USERNAME": "",
      "TIDB_PASSWORD": "",
      "TIDB_DATABASE": ""
    }
  }
}
```

**Requires environment variables:** `TIDB_HOST`, `TIDB_PORT`, `TIDB_USERNAME`, `TIDB_PASSWORD`, `TIDB_DATABASE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# mcp-server-tidb

MCP server implementation for TiDB (serverless) database.

## Prerequisites

- uv (Python package installer)

## 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](https://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](https://modelcontextprotocol.io/quickstart/user)

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