TiDB MCP 服务器

一个用于 TiDB 的模型上下文协议 (MCP) 服务器，允许通过 MCP 工具执行 SELECT 查询。

特性

• 在 TiDB 上执行 SELECT 查询
• 通过环境变量进行安全连接
• 轻量级且易于使用

前提条件

• Node.js 16+
• TiDB 实例

安装

通过 npx

npx tidb-mcp-server

全局安装

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

配置

在运行之前设置以下环境变量：

export TIDB_HOST="你的_tidb_host"
export TIDB_PORT="你的_tidb_端口"
export TIDB_USER="你的_用户名"
export TIDB_PASS="你的_密码"
export TIDB_DB="你的_数据库"

# 可选的操作权限（默认：false）
export ALLOW_INSERT_OPERATION="false"  # 设置为 "true" 以允许 INSERT 操作
export ALLOW_UPDATE_OPERATION="false"  # 设置为 "true" 以允许 UPDATE 操作
export ALLOW_DELETE_OPERATION="false"  # 设置为 "true" 以允许 DELETE 操作

警告：启用这些操作可能会使您的数据库面临修改风险。
仅启用您需要的功能，并确保已实施适当的访问控制。

用法

1. 启动服务器：

tidb-server

2. 添加到 MCP 配置 (cline_mcp_settings.json)：

{
  "mcpServers": {
    "tidb-server": {
      "command": "npx",
      "args": ["-y", "tidb-mcp-server"], // 为了保持一致性，也添加了 -y 标志
      "env": {
        "TIDB_HOST": "你的_tidb_host",
        "TIDB_PORT": "你的_tidb_端口",
        "TIDB_USER": "你的_用户名",
        "TIDB_PASS": "你的_密码",
        "TIDB_DB": "你的_数据库"
      }
    }
  }
}

3. 使用 MCP 工具：

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

开发

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 构建：

npm run build

4. 运行：

node build/index.js

许可证

MIT