MCP Server Tidbcloud

MCP数据服务

提供方 likidu · 包名 @modelcontextprotocol/inspector

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

TiDB Cloud MCP服务器是一个通过自然语言实现LLM与TiDB Cloud交互的协议服务,提供集群管理、分支管理、数据库操作等功能。

一句话选型结论

按资料字段整理

MCP Server Tidbcloud 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 16 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量16暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

数据库管理TypeScript本地部署自然语言交互集群管理SQL操作LLM集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector node packages/server/dist/index.js

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 16 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 16 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Server Tidbcloud当前 16 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方likidu上游标注的维护方 likidu
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.1 KB
来自项目仓库与上游目录的原文,未做删改

TiDB云MCP服务器

MCP(模型上下文协议)服务器,使LLM能够通过自然语言与TiDB Cloud交互。

特性

  • 群集管理:创建、列出、更新和删除TiDB Cloud无服务器集群
  • 分行管理:为集群创建、列出、获取和删除分支
  • 数据库操作:执行SQL查询并管理数据库架构
  • 区域发现:列出可用于创建集群的区域
  • 异步操作支持:通过状态检查正确处理长时间运行的操作
  • 两种运输方式:
  • 标准:Claude Desktop的本地服务器(env vars中的API密钥)
  • 流式HTTP:托管部署的远程服务器(标头中的API密钥)

先决条件

  • Node.js 22或更高版本
  • pnpm包管理器
  • 具有API访问权限的TiDB云帐户

获取API密钥

  1. 登录到 TiDB云控制台
  2. 点击左侧边栏中的组织名称
  3. 引导到 组织设置 → API密钥
  4. 点击 创建API密钥
  5. 复制这两个 公钥 和 私钥 (安全保存私钥,不会再次显示)

安装```bash

Clone the repository

git clone https://github.com/tidbcloud/mcp-server-tidbcloud.git
cd mcp-server-tidbcloud

Install dependencies

pnpm install

Build the project

pnpm build


## 使用Claude Desktop

有两种方法可以将此MCP服务器与Claude Desktop一起使用:

### 选项1:本地服务器(stdio)--推荐

使用Claude Desktop中配置的API密钥在本地运行服务器。最适合开发或需要完全控制时。

将以下内容添加到您的Claude Desktop配置文件中(`claude_desktop_config.json`):```json
{
"mcpServers": {
"tidbcloud": {
"command": "node",
"args": ["/path/to/mcp-server-tidbcloud/packages/server/dist/index.js"],
"env": {
"TIDB_CLOUD_PUBLIC_KEY": "your-public-key",
"TIDB_CLOUD_PRIVATE_KEY": "your-private-key"
}
}
}
}

环境变量(本地服务器):

变量 必填 描述
TIDB_CLOUD_PUBLIC_KEY 是 TiDB Cloud API公钥
TIDB_CLOUD_PRIVATE_KEY 是 TiDB Cloud API私钥
TIDB_CLOUD_API_URL 没有 API基本URL(默认为 https://serverless.tidbapi.com)
TIDB_CLOUD_DB_HOST 否 SQL操作的默认数据库主机
TIDB_CLOUD_DB_USER 否 默认数据库用户名
TIDB_CLOUD_DB_PASSWORD 否 默认数据库密码

选项2:远程服务器

使用连接到托管的MCP服务器 mcp-remote.您的API密钥是通过头传递的-它们不存储在服务器上。

Claude桌面配置:```json
{
"mcpServers": {
"TiDB Cloud": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp-server-tidbcloud.workers.dev/mcp",
"--header", "X-TiDB-API-Public-Key:${TIDB_CLOUD_PUBLIC_KEY}",
"--header", "X-TiDB-API-Private-Key:${TIDB_CLOUD_PRIVATE_KEY}"
],
"env": {
"TIDB_CLOUD_PUBLIC_KEY": "your-public-key",
"TIDB_CLOUD_PRIVATE_KEY": "your-private-key"
}
}
}
}


**使用数据库凭据(用于SQL操作):**

使用数据库工具(`show_databases`, `db_query`, `db_execute`等),配置您的数据库凭据。凭据存储在本地,并通过自定义标头发送:```json
{
"mcpServers": {
"TiDB Cloud": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp-server-tidbcloud.workers.dev/mcp",
"--header", "X-TiDB-API-Public-Key:${TIDB_CLOUD_PUBLIC_KEY}",
"--header", "X-TiDB-API-Private-Key:${TIDB_CLOUD_PRIVATE_KEY}",
"--header", "X-TiDB-DB-Host:${TIDB_CLOUD_DB_HOST}",
"--header", "X-TiDB-DB-User:${TIDB_CLOUD_DB_USER}",
"--header", "X-TiDB-DB-Password:${TIDB_CLOUD_DB_PASSWORD}"
],
"env": {
"TIDB_CLOUD_PUBLIC_KEY": "your-public-key",
"TIDB_CLOUD_PRIVATE_KEY": "your-private-key",
"TIDB_CLOUD_DB_HOST": "gateway01.us-east-1.prod.aws.tidbcloud.com",
"TIDB_CLOUD_DB_USER": "your-username",
"TIDB_CLOUD_DB_PASSWORD": "your-password"
}
}
}
}

要获取集群的主机,请使用 tidbcloud_get_cluster 工具-它将显示连接端点。您的用户名格式通常为 {userPrefix}.root 哪里 userPrefix 如集群详细信息所示。

可用工具

区域工具

tidbcloud_list_regions

列出TiDB Cloud无服务器集群的所有可用区域。

参数: 无

群集管理

tidbcloud_list_clusters

列出您组织中的所有TiDB Cloud无服务器集群。

参数:

  • pageSize (可选):每页的簇数(1-100,默认10)
  • pageToken (可选):用于获取下一页的令牌

tidbcloud_get_cluster

获取特定群集的详细信息,包括连接端点(主机和端口)。

参数:

  • cluster (必填):集群名称或ID

tidbcloud_create_cluster

创建新的TiDB Cloud无服务器集群。这是一个异步操作-集群最初将处于CREATING状态。

参数:

  • displayName (必需):群集的显示名称(最多64个字符)
  • region (必填):云区域名称(使用 tidbcloud_list_regions 获取有效值)
  • rootPassword (可选):根密码。如果未提供,则自动生成
  • spendingLimitMonthly (可选):每月支出限额(美元)
  • labels (可选):集群的键值标签

tidbcloud_update_cluster

更新现有群集的配置。

参数:

  • cluster (必需):要更新的群集名称或ID
  • displayName (可选):新显示名称
  • spendingLimitMonthly (可选):每月支出限额(美元)
  • labels (可选):键值标签

tidbcloud_delete_cluster

删除群集。 警告:这是不可逆转的!

参数:

  • cluster (必填):要删除的群集名称或ID

分行管理

tidbcloud_list_branches

列出集群的所有分支。

参数:

  • cluster (必填):集群名称或ID
  • pageSize (可选):每页分支数量(1-100)
  • pageToken (可选):分页标记

tidbcloud_get_branch

获取特定分支的详细信息,包括连接端点。用于检查分支是否已完成创建。

参数:

  • cluster (必填):集群名称或ID
  • branch (必填):分行名称或ID

tidbcloud_create_branch

为TiDB Cloud Starter或Essential集群创建新分支。这是一个异步操作。

参数:

  • cluster (必填):集群名称或ID
  • displayName (必填):新分支的显示名称(最多64个字符)
  • parentId (可选):父分支ID(默认为主集群)
  • parentTimestamp (可选):RFC3339时间点分支的时间戳

tidbcloud_delete_branch

删除分支。 警告:这是不可逆转的!

参数:

  • cluster (必填):集群名称或ID
  • branch (必填):要删除的分支机构名称或ID

数据库操作

数据库工具需要连接凭据。通过环境变量设置它们或将其作为参数传递。

show_databases

列出TiDB Cloud集群中的所有数据库。

参数:

  • host (可选):数据库主机覆盖
  • username (可选):用户名覆盖
  • password (可选):密码覆盖

show_tables

列出指定数据库中的所有表。

参数:

  • database (必填):用于列出表的数据库
  • host (可选):数据库主机覆盖
  • username (可选):用户名覆盖
  • password (可选):密码覆盖

db_query

执行只读SQL查询。只允许使用SELECT、SHOW、DESCRIBE和EXPLAIN语句。

参数:

  • sql (必需):要执行的只读SQL查询
  • database (可选):用于查询的数据库
  • host (可选):数据库主机覆盖
  • username (可选):用户名覆盖
  • password (可选):密码覆盖

db_execute

执行修改数据或架构的SQL语句(INSERT、UPDATE、DELETE、CREATE、ALTER、DROP)。 警告:这可能会修改或删除数据。

参数:

  • sql (必填):要执行的SQL语句或语句数组
  • database (可选):要使用的数据库
  • host (可选):数据库主机覆盖
  • username (可选):用户名覆盖
  • password (可选):密码覆盖

db_create_user

创建新的数据库用户。

参数:

  • username (必填):新用户的用户名
  • password (必填):新用户的密码
  • userHost (可选):主机限制(默认值:任何主机的“%”)
  • host (可选):管理数据库主机覆盖
  • adminUsername (可选):管理员用户名覆盖
  • adminPassword (可选):管理员密码覆盖

db_remove_user

删除数据库用户。 警告:这是不可逆转的!

参数:

  • username (必填):要删除的用户的用户名
  • userHost (可选):主机规格(默认值:“%”)
  • host (可选):管理数据库主机覆盖
  • adminUsername (可选):管理员用户名覆盖
  • adminPassword (可选):管理员密码覆盖

异步操作

一些操作(集群创建、分支创建、删除)是异步的。工具将立即返回当前状态,您可以使用相应的 get 用于检查操作何时完成的工具:

  • 之后 tidbcloud_create_cluster:使用 tidbcloud_get_cluster 检查状态从何时更改 CREATING 到 ACTIVE
  • 之后 tidbcloud_create_branch:使用 tidbcloud_get_branch 检查状态从何时更改 CREATING 到 ACTIVE

发展```bash

Run in development mode with auto-reload

pnpm dev

Build the project

pnpm build

Clean build artifacts

pnpm clean

Test with MCP Inspector (stdio server)

TIDB_CLOUD_PUBLIC_KEY='your-key' TIDB_CLOUD_PRIVATE_KEY='your-key' \
npx @modelcontextprotocol/inspector node packages/server/dist/index.js


### 使用MCP检查器测试远程服务器

要使用API密钥身份验证在本地测试远程HTTP服务器,请执行以下操作:

1. 启动远程服务器:```bash
pnpm dev:remote
  1. 在单独的终端中,通过以下方式连接MCP检查器 mcp-remote 使用API密钥头:```bash
    npx @modelcontextprotocol/inspector \
    npx mcp-remote http://localhost:3000/mcp \
    --header "X-TiDB-API-Public-Key:YOUR_PUBLIC_KEY" \
    --header "X-TiDB-API-Private-Key:YOUR_PRIVATE_KEY"

## 项目结构```
mcp-server-tidbcloud/
├── packages/
│   ├── server/                    # Core MCP Server (stdio transport)
│   │   ├── src/
│   │   │   ├── index.ts           # Entry point
│   │   │   ├── server.ts          # MCP server setup
│   │   │   ├── config.ts          # Configuration
│   │   │   ├── api/
│   │   │   │   ├── client.ts      # TiDB Cloud API client
│   │   │   │   └── types.ts       # Type definitions
│   │   │   ├── db/
│   │   │   │   ├── client.ts      # Database client
│   │   │   │   └── types.ts       # Database types
│   │   │   └── tools/
│   │   │       ├── index.ts       # Tool exports
│   │   │       ├── cluster.ts     # Cluster management tools
│   │   │       ├── branch.ts      # Branch management tools
│   │   │       ├── database.ts    # Database SQL tools
│   │   │       └── region.ts      # Region discovery tools
│   │   ├── package.json
│   │   └── tsconfig.json
│   │
│   └── remote/                    # Remote MCP Server (HTTP transport)
│       ├── src/
│       │   ├── app.ts             # Hono web app
│       │   ├── config.ts          # Configuration
│       │   ├── dev.ts             # Local dev server
│       │   ├── landing.ts         # Landing page
│       │   ├── skill.ts           # Skill documentation
│       │   ├── worker.ts          # Cloudflare Workers entry point
│       │   └── middleware/        # Security middleware
│       ├── package.json
│       └── wrangler.toml          # Cloudflare Workers configuration
│
├── package.json                   # Root workspace config
├── pnpm-workspace.yaml
└── tsconfig.base.json

TiDB云限制

集群限制

  • 无服务器集群在特定地区可用(使用 tidbcloud_list_regions 查看可用区域)
  • 可以配置支出限额以控制成本

分支限制

  • 每个组织最多5个分支机构(默认配额)
  • 无法对大于100 GiB的群集进行分支
  • 分支是在与父集群相同的区域中创建的
  • 免费入门群集:时间点限制为最后24小时
  • 付费集群:时间点限制为过去14天

安全

安全注意事项

此MCP服务器具有强大的数据库管理功能。请查看以下安全指南:

  • 始终审查行动:在执行之前审查和授权LLM要求的行动
  • 开发利用:此服务器用于本地开发和IDE集成
  • API密钥安全:永远不要在客户端代码或公共存储库中公开API密钥
  • 访问控制:确保只有授权用户才能访问您的MCP服务器URL
  • 审核访问权限:监控使用情况并定期审核谁可以访问您的API密钥

环境变量安全

  • 使用环境变量或秘密管理工具安全地存储API密钥
  • 永不承诺 .env 包含真实凭据的文件
  • 定期旋转API密钥

只读模式

为了更安全的操作 db_query 该工具只允许只读SQL语句(SELECT、SHOW、DESCRIBE、EXPLAIN)。对于数据修改,请使用 db_execute 小心。

有关更多信息,请参阅 MCP安全最佳实践.

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Server Tidbcloud 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector node packages/server/dist/index.js。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

MCP Server Tidbcloud 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Server Tidbcloud 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Server Tidbcloud 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Server Tidbcloud 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Server Tidbcloud 能提供哪些能力?

资料显示约 16 个工具;能力标签包括 数据分析、集群管理、TypeScript、Claude、自然语言交互。具体工具清单以官方文档为准。

MCP Server Tidbcloud 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

MCP Server Tidbcloud 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。