{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hesq2ned26vv","handle":"mysql-mcp-server-plus","url":"https://wellknown.network/agents/mysql-mcp-server-plus","links":{"self":"https://wellknown.network/agents/mysql-mcp-server-plus/record.json","html":"https://wellknown.network/agents/mysql-mcp-server-plus","markdown":"https://wellknown.network/agents/mysql-mcp-server-plus/record.md","api":"https://wellknown.network/api/v1/agents/mysql-mcp-server-plus","status":"https://wellknown.network/api/v1/agents/mysql-mcp-server-plus/status","claim":"https://wellknown.network/agents/mysql-mcp-server-plus/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mysql-mcp-server-plus/claim.json","badge":"https://wellknown.network/agents/mysql-mcp-server-plus/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:mysql-mcp-server-plus","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mysql-mcp-server-plus","summary":"A safe MySQL Model Context Protocol server","description":"# MySQL MCP Server \n \n[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/) \n[![MCP](https://img.shields.io/badge/MCP-Python%20SDK%20v2-6B4EFF)](https://modelcontextprotocol.io/) \n[![uv](https://img.shields.io/badge/managed%20by-uv-DE5FE9?logo=uv&logoColor=white)](https://docs.astral.sh/uv/) \n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) \n \n一个基于官方 MCP Python SDK v2 的 MySQL Model Context Protocol（MCP）服务。它通过 **database 白名单**、**MySQL SQL 安全审计** 与 **数据库账号最小权限**，向 MCP 客户端提供受控的 MySQL 查询、元数据读取和可选写入能力。 \n \n## 功能 \n \n- 使用官方 `mcp` Python SDK v2，首期采用 stdio transport。 \n- 使用 `uv` 管理 Python 版本、依赖和锁文件。 \n- 通过 `MYSQL_ALLOWED_DATABASES` 限制可访问的 database。 \n- 支持切换当前 database、执行 SQL、列出表、查看表字段/索引、统计表数量。 \n- 默认只读；关闭只读后仅允许受控 DML 及表、索引、视图相关 DDL。 \n- 拒绝多语句、注释、账户/权限管理、文件读写、复制、例程、触发器、事件和事务控制等高风险 SQL。 \n- 查询默认分页，避免单次返回过大结果集。 \n \n## 前置条件 \n \n- Python 3.10 或更高版本。 \n- 已安装 [uv](https://docs.astral.sh/uv/getting-started/installation/)。 \n- 可访问的 MySQL 服务。建议使用仅具备必要 database 权限的专用账号。 \n \n## 安装 \n \n克隆仓库后，在项目根目录执行： \n \n```powershell \nuv sync --all-groups \n``` \n \n该命令会根据 `uv.lock` 创建 `.venv` 并安装所有运行、开发依赖。 \n \n## 配置 \n \n服务通过环境变量读取连接与安全配置。 \n \n| 环境变量 | 必填 | 默认值 | 说明 | \n|---|:---:|---|---| \n| `MYSQL_HOST` | 是 | - | MySQL 主机地址 | \n| `MYSQL_PORT` | 否 | `3306` | MySQL 端口，范围为 1-65535 | \n| `MYSQL_USER` | 是 | - | MySQL 用户名 | \n| `MYSQL_PASSWORD` | 是 | - | MySQL 密码；服务不会写入日志或响应 | \n| `MYSQL_DEFAULT_DATABASE` | 是 | - | 启动时使用的 database，必须在白名单中 | \n| `MYSQL_ALLOWED_DATABASES` | 是 | - | 允许访问的 database，以英文逗号分隔 | \n| `MYSQL_READ_ONLY` | 否 | `true` | `true` 时仅允许安全只读 SQL | \n| `MYSQL_CONNECT_TIMEOUT` | 否 | `10` | 连接超时秒数，范围为 1-60 | \n| `MYSQL_LOG_LEVEL` | 否 | `INFO` | `DEBUG`、`INFO`、`WARNING`、`ERROR` 或 `CRITICAL` | \n \nPowerShell 示例： \n \n```powershell \n$env:MYSQL_HOST = \"127.0.0.1\" \n$env:MYSQL_PORT = \"3306\" \n$env:MYSQL_USER = \"mcp_readonly\" \n$env:MYSQL_PASSWORD = \"replace-with-a-secret\" \n$env:MYSQL_DEFAULT_DATABASE = \"appdb\" \n$env:MYSQL_ALLOWED_DATABASES = \"a…","publisher":{"name":"CleanCode","url":null},"homepage":null,"repository":null,"version":"1.0.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mysql-mcp-server-plus","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"}],"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-server-plus","registry":"pypi","observedAt":"2026-09-10T07:21:45.455Z","publishedAt":"2026-08-05T03:12:54.231762Z","latestVersion":"1.0.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mysql-mcp-server-plus","url":"https://pypi.org/project/mysql-mcp-server-plus/","firstSeenAt":"2026-09-10T07:20:54.963Z","fetchedAt":"2026-09-10T07:20:54.963Z","normalizedAt":"2026-09-10T07:20:54.963Z"}]},"firstSeenAt":"2026-09-10T07:20:54.963Z","updatedAt":"2026-09-10T07:21:45.455Z"}