Skip to main content
Glama
TiDB MCP Server

TiDB MCP Server

by l1806858547

Servidor MCP de TiDB

insignia de herrería

Un servidor de Protocolo de Contexto de Modelo (MCP) para TiDB que permite ejecutar consultas SELECT a través de herramientas MCP.

Características

  • Ejecutar consultas SELECT en TiDB

  • Conexión segura a través de variables de entorno

  • Ligero y fácil de usar.

Related MCP server: MCP Server for MySQL

Prerrequisitos

  • Node.js 16+

  • Instancia de TiDB

Instalación

Instalación mediante herrería

Para instalar TiDB Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @l1806858547/tidb-server --client claude

Vía npx

npx tidb-mcp-server

Instalación global

npm install -g tidb-mcp-server
tidb-mcp-server

Configuración

Establezca estas variables de entorno antes de ejecutar:

export TIDB_HOST="your_tidb_host"
export TIDB_PORT="your_tidb_port" 
export TIDB_USER="your_username"
export TIDB_PASS="your_password"
export TIDB_DB="your_database"

# Optional operation permissions (default: false)
export ALLOW_INSERT_OPERATION="false"  # Set to "true" to allow INSERT operations
export ALLOW_UPDATE_OPERATION="false"  # Set to "true" to allow UPDATE operations 
export ALLOW_DELETE_OPERATION="false"  # Set to "true" to allow DELETE operations

WARNING: Enabling these operations may expose your database to modification risks.
Only enable what you need and ensure proper access controls are in place.

Uso

  1. Iniciar el servidor:

tidb-server
  1. Agregar a la configuración de MCP (cline_mcp_settings.json):

{
  "mcpServers": {
    "tidb-server": {
      "command": "npx",
      "args": ["-y", "tidb-mcp-server"], # Also adding the -y flag for consistency
      "env": {
        "TIDB_HOST": "your_tidb_host",
        "TIDB_PORT": "your_tidb_port",
        "TIDB_USER": "your_username",
        "TIDB_PASS": "your_password",
        "TIDB_DB": "your_database"
      }
    }
  }
}
  1. Utilice la herramienta MCP:

const result = await use_mcp_tool({
  server_name: 'tidb-server',
  tool_name: 'tidb_query', 
  arguments: {
    sql: 'SELECT * FROM your_table LIMIT 10'
  }
});

Desarrollo

  1. Clonar el repositorio:

git clone https://github.com/l1806858547/tidb-server.git
cd tidb-server
  1. Instalar dependencias:

npm install
  1. Construir:

npm run build
  1. Correr:

node build/index.js

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

1 tool
tidb_queryC

Execute SQL queries against TiDB

Inputs: sql (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The naming pattern is straightforward and clear.

    Tool Count2/5

    A single tool is too few for a database server like TiDB, which typically requires operations beyond just querying (e.g., schema management, data manipulation, administration). This minimal set severely limits functionality.

    Completeness1/5

    The tool surface is severely incomplete for a TiDB server. It only supports query execution, missing essential operations like creating/dropping tables, inserting/updating/deleting data, managing indexes, or handling transactions.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.
      1,462 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
      20,570 npm
      2,212
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server that enables SQL operations (SELECT, INSERT, UPDATE, DELETE) and table management through a standardized interface with SQLite databases.
      7
      70 npm
      1
      ISC