{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3bb66rfg5bge","handle":"mysql-mcp-plus","url":"https://wellknown.network/agents/mysql-mcp-plus","links":{"self":"https://wellknown.network/agents/mysql-mcp-plus/record.json","html":"https://wellknown.network/agents/mysql-mcp-plus","markdown":"https://wellknown.network/agents/mysql-mcp-plus/record.md","api":"https://wellknown.network/api/v1/agents/mysql-mcp-plus","status":"https://wellknown.network/api/v1/agents/mysql-mcp-plus/status","claim":"https://wellknown.network/agents/mysql-mcp-plus/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mysql-mcp-plus/claim.json","badge":"https://wellknown.network/agents/mysql-mcp-plus/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:mysql-mcp-plus","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mysql-mcp-plus","summary":"轻量级、STDIO-only、支持多个 MySQL 数据源的 MCP 服务","description":"# mysql-mcp-plus\n\n`mysql-mcp-plus` 是一个本地运行、仅使用 STDIO 传输的 MySQL MCP 服务。单个 MCP\n进程可以声明多个数据源，每次工具调用都必须显式指定 `datasource`，适合把开发、测试、\n生产只读库等连接放在同一个 MCP 客户端配置中。\n\n当前版本为 `0.1.1`，正式支持 MySQL 5.7 和 8.x。MariaDB、Percona 仅保证基础连接与 SQL\n尽力兼容。\n\n项目只提供通用的数据源发现、连通性检查和 SQL 执行能力，不提供 HTTP/SSE 服务、OAuth、\nSSH 隧道、连接池、自动重试、完整 mysql CLI，也不提供专用的表结构、索引或健康检查工具。\n\n## 运行要求\n\n- Python 3.11 或更高版本\n- [uv](https://docs.astral.sh/uv/)\n- MCP 客户端能够启动本地 STDIO 服务\n- 至少一个可访问的 MySQL 账号和数据库\n\nWindows 可通过 WinGet 安装 uv：\n\n```powershell\nwinget install --id astral-sh.uv --exact\nuv --version\n```\n\nmacOS/Linux 可使用 uv 官方安装脚本：\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nuv --version\n```\n\n安装后如果当前终端还找不到 `uv`，请按安装程序提示把 uv 目录加入 `PATH`，或重新打开终端。\n\n从源码安装依赖：\n\n```console\ngit clone <仓库地址>\ncd mysql_mcp_plus\nuv sync --all-groups\n```\n\n验证入口命令可用：\n\n```console\nuv run mysql-mcp-plus\nuv run mysql-mcp-multi\nuv run python -m mysql_mcp_multi\n```\n\n`mysql-mcp-plus` 是主命令；`mysql-mcp-multi` 是兼容别名。这三个入口都先验证环境配置，\n再启动 STDIO MCP。配置错误写入 stderr 并以退出码 `2`\n结束；启动阶段不会连接数据库。\n\n## 配置\n\n服务只读取进程环境变量，不会自动加载 `.env`。`MYSQL_SOURCES` 声明数据源名称，每个名称\n再映射到一组 `MYSQL_<数据源大写>_*` 变量。\n\n### 全局变量\n\n| 环境变量 | 必填 | 默认值 | 规则 |\n|---|---:|---:|---|\n| `MYSQL_SOURCES` | 是 | 无 | 逗号分隔且至少一个；名称匹配 `^[a-z][a-z0-9_]*$`，不可重复或留空 |\n| `MYSQL_MAX_ROWS_PER_RESULT` | 否 | `1000` | 正整数；单个结果集最多返回的行数 |\n| `MYSQL_MAX_TOTAL_ROWS` | 否 | `5000` | 正整数，且不得小于单结果集上限；单次调用所有结果集的返回总量 |\n| `MYSQL_MAX_SQL_BYTES` | 否 | `5242880` | 正整数；按 UTF-8 字节数限制完整 SQL 脚本 |\n| `MYSQL_MAX_STATEMENTS` | 否 | `5000` | 正整数；单次脚本中的语句数上限 |\n| `MYSQL_MCP_LOG_LEVEL` | 否 | `INFO` | `DEBUG`、`INFO`、`WARNING`、`ERROR` 或 `CRITICAL`，不区分大小写 |\n\n### 每个数据源的变量\n\n以下表格以名为 `dev` 的数据源为例，实际前缀为 `MYSQL_DEV_`。\n\n| 后缀 | 完整示例 | 必填 | 默认值与规则 |\n|---|---|---:|---|\n| `HOST` | `MYSQL_DEV_HOST` | 否 | `localhost`；空值也回退到默认值 |\n| `PORT` | `MYSQL_DEV_PORT` | 否 | `3306`；整数，范围 `1..65535` |\n| `USER` | `MYSQL_DEV_USER` | 是 | 去除首尾空白后不可为空 |\n| `PASSWORD` | `MYSQL_DEV_PASSWORD` | 否 | 空字符串；保留原始值，不做 `.env` 解析 |\n| `DATABASE` | `MYSQL_DEV_DATABASE` | 是 | 去除首尾空白后不可为空，作为连接默认库 |\n| `ROLE` | `MYS…","publisher":{"name":"若清风","url":null},"homepage":"https://github.com/mjwyr/mysql_mcp_plus","repository":"https://github.com/mjwyr/mysql_mcp_plus","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mysql","mcp","model-context-protocol","multi-datasource","database"],"pricing":null,"endpoints":[{"url":"pypi:mysql-mcp-plus","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mysql-mcp-plus","registry":"pypi","observedAt":"2026-09-10T07:21:44.717Z","publishedAt":"2026-08-05T05:09:57.207732Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mysql-mcp-plus","url":"https://pypi.org/project/mysql-mcp-plus/","firstSeenAt":"2026-09-10T07:20:52.941Z","fetchedAt":"2026-09-10T07:20:52.941Z","normalizedAt":"2026-09-10T07:20:52.941Z"}]},"firstSeenAt":"2026-09-10T07:20:52.941Z","updatedAt":"2026-09-10T07:21:44.717Z"}