{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_y2num96q964a","handle":"mysql-mcp-server-ddz","url":"https://wellknown.network/agents/mysql-mcp-server-ddz","links":{"self":"https://wellknown.network/agents/mysql-mcp-server-ddz/record.json","html":"https://wellknown.network/agents/mysql-mcp-server-ddz","markdown":"https://wellknown.network/agents/mysql-mcp-server-ddz/record.md","api":"https://wellknown.network/api/v1/agents/mysql-mcp-server-ddz","status":"https://wellknown.network/api/v1/agents/mysql-mcp-server-ddz/status","claim":"https://wellknown.network/agents/mysql-mcp-server-ddz/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mysql-mcp-server-ddz/claim.json","badge":"https://wellknown.network/agents/mysql-mcp-server-ddz/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:mysql-mcp-server-ddz","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mysql_mcp_server_ddz","summary":"A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases. This server allows AI assistants to list tables, read data, and execute SQL queries through a controlled interface, making database exploration and analysis safer and more structured.","description":"# MySQL MCP Server（基于 FastMCP 的 MySQL 工具服务器）\n\n一个基于 **Model Context Protocol (MCP)** 的 MySQL 服务器，使用 **FastMCP** 框架实现，\n用于让 AI 应用（例如 Claude Desktop、支持 MCP 的 IDE 等）安全地访问和操作 MySQL 数据库。\n\n> **定位**：这是一个“给大模型用的 MySQL 工具层”，不是传统意义上的 Web API 服务。\n>\n> 你可以把它理解成：把 MySQL 封装成一个 MCP Server，\n> 让 LLM 通过标准协议调用“列出表、查看表数据、执行 SQL”这类能力。\n\n---\n\n## 功能概览\n\n- **列出表**：\n  - 通过资源 `mysql://tables` 列出当前数据库下所有表名\n- **查看表数据**：\n  - 通过资源 `mysql://{table}/data` 读取指定表前 100 行，返回 CSV 文本\n- **执行 SQL**：\n  - 提供工具 `execute_sql(query: str)`，可以执行任意 SQL（读写都可以）\n  - 对 `SHOW TABLES` 做了专门格式处理，保持与历史版本兼容\n- **环境变量配置**：\n  - 所有数据库连接参数都来自环境变量，便于在本地 / 服务器 / 容器中统一管理\n- **日志完善**：\n  - 所有关键路径（连接、查询、错误）都有日志记录，便于调试\n\n---\n\n## 技术栈\n\n- **语言与运行环境**：\n  - Python 3.11+\n- **MCP 框架**：\n  - [`fastmcp`](https://pypi.org/project/fastmcp/) —— 高层 MCP Server 框架\n- **数据库驱动**：\n  - `mysql-connector-python`\n- **项目打包 / 构建**：\n  - `pyproject.toml` + `hatchling`\n- **测试**：\n  - `pytest` + `pytest-asyncio`（目前示例测试只覆盖配置和基本初始化）\n\n---\n\n## 安装与依赖\n\n> 建议使用 [`uv`](https://github.com/astral-sh/uv) 管理 Python 环境和依赖（更快、更干净）。\n\n### 1. 克隆仓库\n\n```bash\ngit clone https://github.com/designcomputer/mysql_mcp_server_ddz.git\ncd mysql_mcp_server_ddz\n```\n\n### 2. 安装依赖（推荐 uv）\n\n在项目根目录执行：\n\n```bash\nuv pip install -r requirements.txt\n```\n\n如果你希望开发 /运行测试，还可以安装开发依赖：\n\n```bash\nuv pip install -r requirements-dev.txt\n```\n\n> 依赖的核心部分：\n>\n> - `fastmcp`\n> - `mysql-connector-python>=9.1.0`\n\n如果你是通过 PyPI 安装（发布包名称可能为 `mysql-mcp-server`），可以：\n\n```bash\npip install mysql-mcp-server\n```\n\n> 具体包名以实际发布为准，这个仓库的源码已经适配 fastmcp。  \n> 若仅在本地使用，可以直接 `uv pip install -e .` 做可编辑安装。\n\n---\n\n## 数据库配置（环境变量）\n\n所有数据库连接信息都通过环境变量传入，这对本地、服务器、容器都适用。\n\n必须配置：\n\n```bash\nMYSQL_HOST=localhost      # 数据库主机\nMYSQL_PORT=3306           # 端口（可选，默认 3306）\nMYSQL_USER=root           # 数据库用户名\nMYSQL_PASSWORD=123456     # 数据库密码\nMYSQL_DATABASE=jspt       # 要连接的数据库名\n```\n\n可选配置（兼容性与高级配置）：\n\n```bash\nMYSQL_CHARSET=utf8mb4\nMYSQL_COLLATION=utf8mb4_unicode_ci\nMYSQL_SQL_MODE=TRADITIONAL\n```\n\n> 如果缺少 `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE` 中任意一个，\n> 在启动时会直接抛出 `Value…","publisher":null,"homepage":null,"repository":null,"version":"0.2.6","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mysql_mcp_server_ddz","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":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.688,"provenance":"derived"}],"categories":["data","dev"],"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_ddz","registry":"pypi","observedAt":"2026-09-10T07:21:45.167Z","publishedAt":"2026-01-13T09:55:15.922682Z","latestVersion":"0.2.6"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mysql_mcp_server_ddz","url":"https://pypi.org/project/mysql_mcp_server_ddz/","firstSeenAt":"2026-09-10T07:20:54.240Z","fetchedAt":"2026-09-10T07:20:54.240Z","normalizedAt":"2026-09-10T07:20:54.240Z"}]},"firstSeenAt":"2026-09-10T07:20:54.240Z","updatedAt":"2026-09-10T07:21:45.167Z"}