Skip to main content

Add your description here

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mseep_mcp_server_tidb-0.1.1.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mseep_mcp_server_tidb-0.1.1-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file mseep_mcp_server_tidb-0.1.1.tar.gz.

File metadata

  • Download URL: mseep_mcp_server_tidb-0.1.1.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for mseep_mcp_server_tidb-0.1.1.tar.gz
Algorithm Hash digest
SHA256 071afc50b5b21fce635fdae22d28b72b9fc071f9904b4b2bddfd6537e5464da7
MD5 5133c78ae685c8e820c7cc94dc690976
BLAKE2b-256 2542f2454f75c3cacdb55f8b7bb04998238101d1b721458e789a9304741a48aa

See more details on using hashes here.

File details

Details for the file mseep_mcp_server_tidb-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mseep_mcp_server_tidb-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 788d3f522cac3882fa822439b146ce92a3bff78fb4f3be178f10ece9c8bc5ac7
MD5 0d59ef92d688014c0214a373ee8847e2
BLAKE2b-256 965cef726ab7ddebd377fe4d27816167b347ae22c9fe7d31691e330d18de4099

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page