文档首页/ 云数据库 TaurusDB/ 用户指南/ 使用TaurusDB MCP
更新时间：2026-07-31 GMT+08:00
查看PDF
分享

使用TaurusDB MCP

操作场景

在日常的数据管理和分析工作中，用户经常需要与数据库进行交互，执行各种查询和诊断任务。然而，传统的数据库操作方式要求用户具备较高的SQL技能，并且需要频繁地在不同的控制台之间切换，这不仅增加了操作的复杂性，也降低了工作效率。

MCP（Model Context Protocol，模型上下文协议）是一种让 AI 客户端安全调用外部工具和数据源的协议。通过 MCP，Claude Code、Codex、Cursor、VS Code 等 AI 客户端可以连接到本地运行的 MCP Server，再由 MCP Server 代表用户访问数据库、云服务或其他系统。

taurusdb-mcp是一个面向华为云 TaurusDB的MCP Server。用户不需要手工编写复杂SQL或反复切换控制台，可以在AI 客户端中用自然语言发起请求，由AI选择合适的 MCP Tool 完成数据库探查、SQL 执行和问题诊断。

通过使用 MCP 和 taurusdb-mcp，不仅简化了操作流程，还提高了数据管理和分析的效率。

典型使用场景包括：

  • 数据库结构探查：查询数据库列表、表列表、字段、索引和表结构。
  • 只读SQL查询：执行SELECT、SHOW、EXPLAIN等只读语句，获取结构化结果。
  • SQL 执行计划分析：通过explain_sql 或增强诊断能力分析慢 SQL 原因。
  • 数据库运行状态排查：查看processlist、锁等待、热点 SQL、连接增长、存储压力等诊断结果。
  • TaurusDB能力发现：识别当前实例是否支持TaurusDB特有能力，例如热点行、回收站、闪回查询等。
  • 云数据库实例选择：查询账号下的TaurusDB 实例，并将MCP会话绑定到指定实例。

前提条件

使用 taurusdb-mcp 前，请确认已满足以下条件。

  • 本地或运行环境已安装Node.js和npm，Node.js版本高于20。
  • 已安装并可使用一个支持MCP的客户端，例如 Claude Code、Codex、Cursor 或 VS Code。
  • 运行MCP Server 的机器能够访问 TaurusDB数据库地址。
    • 生产或长期使用场景建议将MCP Server部署在与TaurusDB同VPC的ECS。
    • 本地临时调试可使用数据库公网地址，但需要在安全组中只放通当前公网出口IP和必要端口。
  • 已准备 TaurusDB 数据库连接信息：
    • 数据库公网地址和端口。
    • 默认数据库名。
    • 数据库账号和密码。
    • 可选的写入账号和密码，仅用于验证受控写操作或恢复类操作。
  • 只读账号建议至少具备以下权限：
    • 目标库 SELECT 权限。
    • SHOW PROCESSLIST 权限。
    • 如需诊断复制、锁和 InnoDB 状态，建议具备 SHOW REPLICA STATUS 或 SHOW SLAVE STATUS、SHOW ENGINE INNODB STATUS 以及 performance_schema 相关只读权限。
  • 如需使用云数据库能力，需提前准备华为云Region和AK/SK信息。

    AK/SK至少需要具备查看目标Region下TaurusDB实例的权限。AK/SK的获取方式请参见访问密钥。

    区域ID的获取方式请参见地区和终端节点。

  • 使用MCP前需先登录数据库，登录数据库需先选择实例，每个实例有独立的账号和密码；选择实例后，使用对应账号密码登录即可操作数据库。

  • 如需使用性能诊断相关工具，请修改“performance_schema”参数值为“ON”，详细内容请参见修改TaurusDB实例参数。

约束限制

使用 MCP 时需要注意以下限制和安全边界。

  • taurusdb-mcp当前以stdio MCP Server 形态运行，不是HTTP 服务，启动后不会提供浏览器访问地址，需要由MCP客户端拉起和调用。
  • MCP 客户端进程必须能拿到环境变量。建议将数据库和云侧配置直接写入 MCP 客户端配置。
  • execute_readonly_sql 只允许执行只读 SQL，会阻断写入类语句。
  • execute_sql 属于写入能力，只有开启 mutation 配置后才会暴露，并且高风险操作需要先返 confirmation_token，第二次带 token 才会执行。
  • confirmation_token 与首次调用的 SQL、datasource、database 等上下文绑定，通常只能使用一次；参数不一致或 token 已使用会校验失败。
  • 常见情况下，安全组重点是入方向规则；如果你的环境对出方向也做了限制，再补充对应的出方向规则。本机公网 IP 变化后，需要同步更新安全组规则。

    下图展示了一个将本机公网 IP 加入安全组规则的示例：

配置MCP

使用MCP前请先根据您使用客户端工具配置MCP，本章节针对如下常见的客户端提供配置方式。

如下内容中区域信息和AK/SK请替换为实际值。

华为云码道

  1. 先下载安装华为云码道IDE，关于华为云码道的详细内容请参见华为云码道（CodeArts）代码智能体。
  2. 在华为云码道里打开 MCP 配置页，编辑 mcp_settings.json： 
    {
	"mcpServers": {
		"huaweicloud-taurusdb": {
			"command": "npx",
			"args": ["-y", "taurusdb-mcp"],
			"env": {
				"TAURUSDB_CLOUD_REGION": "your-region",
				"TAURUSDB_CLOUD_ACCESS_KEY_ID": "your-ak",
				"TAURUSDB_CLOUD_SECRET_ACCESS_KEY": "your-sk"
			}
		}
	}
}

Claude Code

运行命令行语句：

claude mcp add huaweicloud-taurusdb --transport stdio -s local -e TAURUSDB_CLOUD_REGION=your-region -e TAURUSDB_CLOUD_ACCESS_KEY_ID=your-ak -e TAURUSDB_CLOUD_SECRET_ACCESS_KEY=your-sk -- npx -y taurusdb-mcp

使用如下方式验证：

claude mcp list claude mcp get huaweicloud-taurusdb

Codex

codex mcp add huaweicloud-taurusdb --env TAURUSDB_CLOUD_REGION=your-region --env TAURUSDB_CLOUD_ACCESS_KEY_ID=your-ak --env TAURUSDB_CLOUD_SECRET_ACCESS_KEY=your-sk -- npx -y taurusdb-mcp

使用如下方式验证：

codex mcp list

如果您使用手工维护配置，编辑 ~/.codex/config.toml，新增如下内容：

[mcp_servers.huaweicloud-taurusdb]
command = "npx"
args = ["-y", "taurusdb-mcp"]
enabled = true 

[mcp_servers.huaweicloud-taurusdb.env]
TAURUSDB_CLOUD_REGION = "your-region"
TAURUSDB_CLOUD_ACCESS_KEY_ID = "your-ak"
TAURUSDB_CLOUD_SECRET_ACCESS_KEY = "your-sk"

Cursor

编辑 ~/.cursor/mcp.json，添加如下内容：

{
    "mcpServers": {
        "huaweicloud-taurusdb": {
            "command": "npx",
            "args": [
                "-y",
                "taurusdb-mcp"
            ],
            "env": {
                "TAURUSDB_CLOUD_REGION": "your-region",
                "TAURUSDB_CLOUD_ACCESS_KEY_ID": "your-ak",
                "TAURUSDB_CLOUD_SECRET_ACCESS_KEY": "your-sk"
            }
        }
    }
}

OpenCode

编辑opencode.json文件，添加如下内容：

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "huaweicloud-taurusdb": {
            "type": "local",
            "command": [
                "npx",
                "-y",
                "taurusdb-mcp"
            ],
            "enabled": true,
            "environment": {
                "TAURUSDB_CLOUD_REGION": "your-region",
                "TAURUSDB_CLOUD_ACCESS_KEY_ID": "your-ak",
                "TAURUSDB_CLOUD_SECRET_ACCESS_KEY": "your-sk"
            }
        }
    }
}

Trae

在 Trae 的 MCP 设置里添加下面这段；如果你的版本支持项目级配置，通常可以放到 IDE 提供的 MCP 配置文件里：

{
    "mcpServers": {
        "huaweicloud-taurusdb": {
            "command": "npx",
            "args": [
                "-y",
                "taurusdb-mcp"
            ],
            "env": {
                "TAURUSDB_CLOUD_REGION": "your-region",
                "TAURUSDB_CLOUD_ACCESS_KEY_ID": "your-ak",
                "TAURUSDB_CLOUD_SECRET_ACCESS_KEY": "your-sk"
            }
        }
    }
}

Qwen Code / 通义千问

Qwen Code 常见的配置文件是 ~/.qwen/settings.json。你可以直接把下面这段加进去：

{
    "mcpServers": {
        "huaweicloud-taurusdb": {
            "command": "npx",
            "args": [
                "-y",
                "taurusdb-mcp"
            ],
            "env": {
                "TAURUSDB_CLOUD_REGION": "your-region",
                "TAURUSDB_CLOUD_ACCESS_KEY_ID": "your-ak",
                "TAURUSDB_CLOUD_SECRET_ACCESS_KEY": "your-sk"
            }
        }
    }
}

也可使用命令行配置：

qwen mcp add -t stdio -e TAURUSDB_CLOUD_REGION=your-region -e TAURUSDB_CLOUD_ACCESS_KEY_ID=your-ak -e TAURUSDB_CLOUD_SECRET_ACCESS_KEY=<your-sk> huaweicloud-taurusdb npx -y taurusdb-mcp

CodeBuddy

推荐直接用 codebuddy mcp add-json 写入配置。

codebuddymcpadd-json--scopeuserhuaweicloud-taurusdb'{
    "type": "stdio",
    "command": "npx",
    "args": [
        "-y",
        "taurusdb-mcp"
    ],
    "env": {
        "TAURUSDB_CLOUD_REGION": "your-region",
        "TAURUSDB_CLOUD_ACCESS_KEY_ID": "your-ak",
        "TAURUSDB_CLOUD_SECRET_ACCESS_KEY": "your-sk"
    }
}'

CodeBuddy 的配置文件通常放在以下位置之一：

  • ~/.codebuddy/.mcp.json
  • ~/.codebuddy/mcp.json
  • ~/.codebuddy.json如果你不是用 CLI，就把同样的内容写进对应文件。

验证MCP成功连接

确认MCP成功连接：

使用MCP

TaurusDB MCP提供如下工具，包括数据库连接、实例管理、数据库管理、诊断工具和恢复工具。

表1 TaurusDB MCP提供的工具

工具分类

工具

说明

数据库连接

ping

网络连通性测试。

set_cloud_region

设置华为云区域。

set_cloud_access_keys

设置AK/SK。

get_session_binding

查看当前会话绑定信息。

set_default_database

设置默认数据库。

实例管理

list_cloud_taurus_instances

列出云数据库TaurusDB实例。

select_cloud_taurus_instance

选择云数据库TaurusDB实例。

get_kernel_info

获取指定实例的内核版本信息。

list_taurus_features

获取特性矩阵。

数据库管理

list_databases

列出数据库。

list_tables

列出表。

describe_table

描述表结构。

execute_readonly_sql

执行只读SQL。

execute_sql

执行变更SQL。

explain_sql

执行EXPLAIN。

explain_sql_enhanced

增强EXPLAIN（含 NDP/PQ 提示）。

性能诊断

show_processlist

查看进程列表。

diagnose_service_latency

诊断造成服务延迟的根因。

diagnose_db_hotspot

诊断热点行。

find_top_slow_sql

查找慢SQL。

diagnose_slow_query

诊断慢查询。

diagnose_connection_spike

诊断连接突增。

diagnose_lock_contention

诊断锁竞争。

diagnose_storage_pressure

诊断存储压力。

备份恢复

flashback_query

闪回查询。

list_recycle_bin

列出回收站。

restore_recycle_bin_table

恢复回收站表。

示例：

  • list_cloud_taurus_instances：查询TaurusDB云数据库实例。

  • list_taurus_features：查询TaurusDB特性矩阵。

  • diagnose_slow_query：诊断慢查询根因。

  • diagnose_lock_contention：精准定位会话阻塞Blocker和Waiter。

  • execute_readonly_sql：使用自然语言查询数据。

  • flashback_query：按时间点查询历史态数据。

  • execute_readonly_sql ：对敏感字段进行动态脱敏。

  • list_recycle_bin：误删表秒级恢复。

相关文档