Archestra Logo
Star us on GitHub ⭐
Back to Catalog

mcp-server-tidb

c4pt0r/mcp-server-tidb
🔗 Latest commit:080a1bf
🕒 Updated:Sep 9, 2025, 01:05 PM
Python
Data

mcp server for tidb

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score42/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:22
👥 Contributors:2
📋 Total Issues:0
📦 Has Releases:No
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "mcp-server-tidb": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/mcp-server-tidb",
      "run",
      "src/main.py"
    ],
    "env": {}
  },
  "mcp-server-tidb-wsl": {
    "command": "wsl.exe",
    "args": [
      "bash",
      "-c",
      "/path/to/uv --directory /path/to/mcp-server-tidb run python src/main.py"
    ],
    "env": {}
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:✗
Prompts:✗
Resources:✓
Sampling:✗
Roots:✗
Logging:✗
STDIO Transport:✓
HTTP Transport:✗
OAuth2 Auth:✗
Dependencies
4 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Resources
GitHub Repository
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/c4pt0r/mcp-server-tidb)](https://archestra.ai/mcp-catalog/c4pt0r__mcp-server-tidb)
Edit This ServerAdd New MCP ServerReport an Issue
README.md

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 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"
      ]
    }
  }
}
mcp-server-tidb MCP Server | Documentation & Integration | Archestra