What is the default TiDB port?

The default port is 4000 if TIDB_PORT is not set.

How do I install this MCP server?

Clone the repo, then use 'uv' to create a virtual environment and install with 'uv pip install -e .'.

Can I run this with Claude Desktop?

Yes, configure Claude Desktop to run the server using the provided command and args in claude_desktop_config.json.

MCP Server Tidb

tidbdatabasesqlserverless

MCP server for TiDB providing schema inspection and query execution via environment-configured connection.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for c4pt0r/mcp-server-tidb, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Overview

This MCP server integrates with TiDB, a serverless database, enabling AI agents to inspect database schemas and execute queries. It connects to a TiDB cluster configured via environment variables or a .env file. Use this server when you need AI-driven access to TiDB databases for querying and schema exploration.

Use cases

Inspect TiDB database schema

Execute SQL queries on TiDB

Integrate TiDB data access into AI workflows

Connect AI agents to TiDB clusters

Key features

Schema inspection of TiDB databases

Query execution support

Environment variable configuration

Supports TiDB serverless clusters

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Server Tidb.

Extracted Tool Capabilities

Schema inspection of TiDB databases

Query execution support

Environment variable configuration

Supports TiDB serverless clusters

Documentation Overview

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

Run with Claude Desktop

Config Claude Desktop, HOWTO

claude_desktop_config.json:

JSON Config

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

JSON Config

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Databases View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1y ago

Most recent push to the default branch.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Server Tidb

Set environment variables TIDB_HOST, TIDB_PORT, TIDB_USERNAME, TIDB_PASSWORD, and TIDB_DATABASE or use a .env file.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/c4pt0r-mcp-server-tidb?style=directory)](https://allmcps.com/mcp/c4pt0r-mcp-server-tidb)

HTML Embed

<a href="https://allmcps.com/mcp/c4pt0r-mcp-server-tidb"><img src="https://allmcps.com/api/badge/c4pt0r-mcp-server-tidb?style=directory" alt="MCP Server Tidb on AllMCPs" /></a>

Technical Specs & Signals

CategoryDatabases

PricingFree

32Quality signal: Emerging · 32/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools12/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🗄️ Databases →Best MCP servers for Databases →Alternatives to MCP Server Tidb →Install in Claude Desktop Install in Cursor Install in VS Code

Overview

Use cases

Inspect TiDB database schema

Execute SQL queries on TiDB

Integrate TiDB data access into AI workflows

Connect AI agents to TiDB clusters

Key features

Schema inspection of TiDB databases

Query execution support

Environment variable configuration

Supports TiDB serverless clusters

Documentation Overview

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

Run with Claude Desktop

Config Claude Desktop, HOWTO

claude_desktop_config.json:

JSON Config

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

JSON Config

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