{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_j8rwd9dkzua7","handle":"mysql-mcp-dolphin","url":"https://wellknown.network/agents/mysql-mcp-dolphin","links":{"self":"https://wellknown.network/agents/mysql-mcp-dolphin/record.json","html":"https://wellknown.network/agents/mysql-mcp-dolphin","markdown":"https://wellknown.network/agents/mysql-mcp-dolphin/record.md","api":"https://wellknown.network/api/v1/agents/mysql-mcp-dolphin","status":"https://wellknown.network/api/v1/agents/mysql-mcp-dolphin/status","claim":"https://wellknown.network/agents/mysql-mcp-dolphin/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mysql-mcp-dolphin/claim.json","badge":"https://wellknown.network/agents/mysql-mcp-dolphin/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:mysql-mcp-dolphin","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mysql-mcp-dolphin","summary":"使用FastMCP构建MySql Mcp Server，支持Streamable HTTP, STDIO, SSE，支持读写权限控制","description":"[![PyPI Version](https://img.shields.io/pypi/v/mysql-mcp-xu)](https://pypi.org/project/mysql-mcp-xu)\n[![PyPI Downloads](https://static.pepy.tech/badge/mysql-mcp-xu)](https://pepy.tech/projects/mysql-mcp-xu)\n# MySQL MCP Dolphin\n\n## 项目简介\nMySQL MCP Dolphin 是一个基于 FastMCP 的 MySQL MCP Server项目，提供了一个安全、高效的接口来执行 SQL 操作。该项目支持多种权限控制（读、写、管理员），并通过工具函数实现了表结构查询、索引信息获取、健康状态监控等功能。\n\n## 目录结构\n```\n.\n├── src\n│   └── mysql_mcp_dolphin\n│       ├── __init__.py\n│       ├── config.py\n│       └── mcp_server.py\n├── README.md\n└── pyproject.toml\n```\n\n## 快速开始\n1. 安装：`pip install mysql-mcp-dolphin`\n2. 执行命令的目录创建一个 `.env` 文件，内容如下：\n```bash\nMYSQL_HOST=localhost\nMYSQL_PORT=3306\nMYSQL_USER=your_username\nMYSQL_PASSWORD=your_password\nMYSQL_DATABASE=your_database\nMYSQL_ROLE=r # 可选值: r, w, a\nMYSQL_MAXSIZE=2 # 可选值 连接池最大值\n```\n3. 启动命令：\n   - STDIO：uv run -m mysql_mcp_dolphin.mcp_server \n   - Streamable HTTP： uv run -m mysql_mcp_dolphin.mcp_server sh\n   - SSE: uv run -m mysql_mcp_dolphin.mcp_server sse\n4. 使用 MCP 客户端连接服务并执行 SQL 操作。\n\n## 功能特性\n- **SQL 执行**：支持执行多条 SQL 语句，并返回结果。\n- **权限控制**：根据角色（读、写、管理员）限制 SQL 操作。\n- **表结构查询**：获取指定表的字段名、字段注释等信息。\n- **索引信息获取**：获取指定表的索引名、索引字段、索引类型等信息。\n- **健康状态监控**：获取 MySQL 的健康状态，包括连接数、查询次数、缓冲池使用情况等。\n\n## 权限控制\n权限控制通过 `PERMISSIONS` 字典实现，支持以下角色：\n- `r`：只读权限，允许执行 `SELECT`, `SHOW`, `DESCRIBE`, `EXPLAIN`, `USE` 操作。\n- `w`：读写权限，允许执行 `SELECT`, `SHOW`, `DESCRIBE`, `EXPLAIN`, `INSERT`, `UPDATE`, `DELETE`, `USE` 操作。\n- `a`：管理员权限，允许执行所有操作，包括 `CREATE`, `ALTER`, `DROP`, `TRUNCATE` 等。\n\n## 工具函数\n- `execute_sql`: 执行 SQL 语句并返回结果,SELECT语句没有LIMIT时，自动在sql后加LIMIT 1000。\n- `get_table_structure`: 获取指定表的字段信息。\n- `get_table_indexes`: 获取指定表的索引信息。\n- `search_table_by_name`: 根据表名或表注释搜索数据库中对应的表名。\n- `get_mysql_health`: 获取 MySQL 的健康状态。\n- `get_database_info`: 获取数据库基本信息\n- `get_database_tables`: 获取数据库所有表和对应的表注释\n- `analyze_table_stats`: 分析表统计信息和列统计信息\n- `get_process_list`: 获取当前进程列表\n- `check_table_constraints`: 检查表约束信息\n\n## 部署方式\n\n### 使用 uvx 部署\n\n在 MCP 配置文件中添加如下配置，以使用 `uvx` 部署 MySQL MCP Dolphin 服务：\n#### STDIO\n\n```json\n{\n  \"mcpServers\": {…","publisher":null,"homepage":null,"repository":null,"version":"0.1.5","license":null,"protocols":["mcp"],"tags":["mcp","mcp-server","mysql"],"pricing":null,"endpoints":[{"url":"pypi:mysql-mcp-dolphin","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"}],"categories":["data"],"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-dolphin","registry":"pypi","observedAt":"2026-09-10T07:21:44.607Z","publishedAt":"2026-03-11T11:00:37.328013Z","latestVersion":"0.1.5"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mysql-mcp-dolphin","url":"https://pypi.org/project/mysql-mcp-dolphin/","firstSeenAt":"2026-09-10T07:20:52.697Z","fetchedAt":"2026-09-10T07:20:52.697Z","normalizedAt":"2026-09-10T07:20:52.697Z"}]},"firstSeenAt":"2026-09-10T07:20:52.697Z","updatedAt":"2026-09-10T07:21:44.607Z"}