{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9scv5g7hpjkm","handle":"mysql-mcp-pro","url":"https://wellknown.network/agents/mysql-mcp-pro","links":{"self":"https://wellknown.network/agents/mysql-mcp-pro/record.json","html":"https://wellknown.network/agents/mysql-mcp-pro","markdown":"https://wellknown.network/agents/mysql-mcp-pro/record.md","api":"https://wellknown.network/api/v1/agents/mysql-mcp-pro","status":"https://wellknown.network/api/v1/agents/mysql-mcp-pro/status","claim":"https://wellknown.network/agents/mysql-mcp-pro/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mysql-mcp-pro/claim.json","badge":"https://wellknown.network/agents/mysql-mcp-pro/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:mysql-mcp-pro","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mysql-mcp-pro","summary":"A production-grade MySQL MCP server with connection pooling, transactions, EXPLAIN analysis, CSV/JSON export, ER graph, audit log, and prompt templates.","description":"# mysql-mcp-pro\n\n> 🇺🇸 [English version available here](README.en.md)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io)\n\n一个生产级的 **MySQL MCP Server**，让 AI 助手（Claude Desktop / WorkBuddy / Cursor / Cline 等）通过标准化协议安全高效地操作 MySQL 数据库。\n\n## ✨ 为什么选 mysql-mcp-pro？\n\n相比社区其他 MySQL MCP 实现，本项目提供了更完整的能力集：\n\n| 特性 | mysql-mcp-pro | 其他 MCP |\n|------|:---:|:---:|\n| 连接池（减少握手开销） | ✅ | ❌ |\n| 事务支持（begin/commit/rollback） | ✅ | ❌ |\n| EXPLAIN 自动解读 | ✅ | ❌ |\n| 结果导出 CSV/JSON（Excel 友好 BOM） | ✅ | ❌ |\n| ER 关系图数据（nodes/edges） | ✅ | 少数 |\n| 视图 / 存储过程 / 函数 / 触发器 浏览 | ✅ | 少数 |\n| 查询历史 & 审计日志 | ✅ | ❌ |\n| MCP Prompts 模板（生成/优化/对比/概览） | ✅ | ❌ |\n| 安全分级（只读/DDL/危险语句/超时/行限/参数化） | ✅ | 基础 |\n| 多传输模式（stdio / SSE / streamable-http） | ✅ | 部分 |\n\n## 🚀 快速开始\n\n### 1. 安装\n\n```bash\n# 从源码（推荐先 clone 再使用）\ngit clone https://github.com/CCCT173/mysql-mcp-pro.git\ncd mysql-mcp-pro\npip install -e .\n\n# 或从 PyPI（待发布）\npip install mysql-mcp-pro\n```\n\n### 2. 配置环境变量\n\n复制 `.env.example` 为 `.env` 并编辑：\n\n```env\nMYSQL_HOST=localhost\nMYSQL_PORT=3306\nMYSQL_USER=root\nMYSQL_PASSWORD=your_password\nMYSQL_DATABASE=your_database\n\nREAD_ONLY=false         # 只读模式\nALLOW_DDL=false          # 是否允许 CREATE/ALTER/DROP\nMAX_RESULT_ROWS=1000     # 单次查询最大返回行数\nQUERY_TIMEOUT=30         # 查询超时(秒)\n\nPOOL_SIZE=5\nAUDIT_LOG=true           # 审计日志\nEXPORT_DIR=./exports     # 导出目录\n```\n\n### 3. 在你的 MCP 客户端注册\n\n#### WorkBuddy\n\n编辑 `~/.workbuddy/mcp.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"mysql\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"server\"],\n      \"cwd\": \"D:/path/to/mysql-mcp-pro\",\n      \"env\": {\n        \"MYSQL_HOST\": \"localhost\",\n        \"MYSQL_PORT\": \"3306\",\n        \"MYSQL_USER\": \"root\",\n        \"MYSQL_PASSWORD\": \"your_password\",\n        \"MYSQL_DATABASE\": \"your_database\"\n      }\n    }\n  }\n}\n```\n\n或者如果你已经 `pip install -e .`：\n\n```json\n{\n  \"mcpS…","publisher":{"name":"CCCT173","url":null},"homepage":"https://github.com/CCCT173/mysql-mcp-pro","repository":"https://github.com/CCCT173/mysql-mcp-pro/releases","version":"2.0.2","license":"MIT","protocols":["mcp"],"tags":["ai","claude","cursor","database","llm","mcp","mcp-server","model-context-protocol","mysql","tools"],"pricing":null,"endpoints":[{"url":"pypi:mysql-mcp-pro","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"ai.prompting","name":"Prompt Management","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":0.733,"provenance":"derived"}],"categories":["ai","data","dev","documents"],"language":"fr"},"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-pro","registry":"pypi","observedAt":"2026-09-10T07:21:44.810Z","publishedAt":"2026-07-21T03:49:16.521582Z","latestVersion":"2.0.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mysql-mcp-pro","url":"https://pypi.org/project/mysql-mcp-pro/","firstSeenAt":"2026-09-10T07:20:53.194Z","fetchedAt":"2026-09-10T07:20:53.194Z","normalizedAt":"2026-09-10T07:20:53.194Z"}]},"firstSeenAt":"2026-09-10T07:20:53.194Z","updatedAt":"2026-09-10T07:21:44.810Z"}