dmc-mcp-server

# dmc-mcp-server 通过腾讯云 DMC (Data Management Console) 在 TDSQL-C / TDSQL 数据库实例上执行 SQL 查询的 MCP Server。 ## 原理 ``` 浏览器 (腾讯云控制台登录态) │ Cookie (skey/uin) + mc_gtk (csrfCode) ▼ DMC MCP Server │ ① 按实例类型搜索 API: │ TDSQL-C → cynosdb.cloud.tencent.com DescribeClusters (本地过滤 Vip) │ TDSQL → tdsql.cloud.tencent.com DescribeDCDBInstances (服务端 SearchKey) │ ② RSA 加密 DB 密码 (PKCS#1 v1.5) │ ③ POST dms.cloud.tencent.com/api/mysql/dbLogin → token │ ④ POST dms.cloud.tencent.com/api/mysql/schemaAdmin/commonSql → 查询结果 ▼ TDSQL-C / TDSQL MySQL (内网 IP) ``` 利用腾讯云 DMC 控制台的 Web API，通过浏览器 Cookie 复用登录态，实现从本地对生产内网数据库的 SQL 查询。 ## 安装 ### 方式一：uvx 一键运行（推荐） ```bash uvx dmc-mcp-server ``` ### 方式二：从源码安装 ```bash cd dmc-mcp-server uv sync uv run dmc-mcp-server ``` ## 配置 ### 在 MCP 客户端中添加 在你的 MCP 客户端配置中添加 (如 `opencode.jsonc`, `claude_desktop_config.json`): ```json { "mcpServers": { "dmc-mcp-server": { "command": "uvx", "args": ["dmc-mcp-server"] } } } ``` > Cookie 不写在配置中, 启动后通过 `set_cookie` 工具动态设置. ### Cookie 获取方式 启动 MCP 后, 通过 Chrome DevTools MCP 在腾讯云控制台页面自动获取: ```javascript // Cookie document.cookie // mc_gtk (csrfCode) - 从 performance API 提取 performance.getEntriesByType('resource') .find(e => e.name.includes('csrfCode=')) ?.name.match(/csrfCode=(\d+)/)?.[1] ``` 然后调用 `set_cookie(cookie, mc_gtk)` 工具设置. > 也可手动从浏览器 DevTools 复制 `document.cookie` 的值, 但 mc_gtk 必须从 performance API 提取. ## 工具列表 | 工具 | 说明 | |------|------| | `set_cookie` | 设置/更新腾讯云控制台 Cookie + mc_gtk | | `find_instance_by_ip` | 通过内网 IP 搜索数据库实例（同时搜 TDSQL-C 和 TDSQL） | | `login_instance` | 登录数据库实例（会话缓存，不重复登录） | | `execute_select` | 执行 SELECT 查询（仅允许 SELECT） | | `execute_dml` | 执行 DML/DDL 写语句（INSERT/UPDATE/DELETE/REPLACE/ALTER/CREATE/DROP/TRUNCATE/RENAME，需二次确认） | | `list_databases` | 列出实例上的所有数据库 | | `list_tables` | 列出指定库的表（支持模糊搜索） | | `get_table_detail` | 查看表结构（列信息 + DDL） | | `list_active_sessions` | 查看已登录的实例列表 | ## DML 执行 `execute_dml` 工具用于在生产环境执行 DML/DDL 写…