{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_juda27gx9779","handle":"yooztech-mcp-mysql","url":"https://wellknown.network/agents/yooztech-mcp-mysql","links":{"self":"https://wellknown.network/agents/yooztech-mcp-mysql/record.json","html":"https://wellknown.network/agents/yooztech-mcp-mysql","markdown":"https://wellknown.network/agents/yooztech-mcp-mysql/record.md","api":"https://wellknown.network/api/v1/agents/yooztech-mcp-mysql","status":"https://wellknown.network/api/v1/agents/yooztech-mcp-mysql/status","claim":"https://wellknown.network/agents/yooztech-mcp-mysql/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yooztech-mcp-mysql/claim.json","badge":"https://wellknown.network/agents/yooztech-mcp-mysql/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yooztech-mcp-mysql","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yooztech-mcp-mysql","summary":"MCP server for MySQL (read-only, database-scoped)","description":"## yooztech_mcp_mysql —— 基于 MCP 的 MySQL 工具（只读、安全、支持库推断）\n\n该 MCP 服务器在 MCP 客户端中提供安全的 MySQL 读取能力：\n- `connect_project_database(project_root)`：识别项目类型，直接读取项目数据库配置并建立连接；凭据不会返回给 AI\n- `list_databases()`：列出当前账号可访问的非系统库\n- `infer_database(project_root=None, include_evidence=false)`：根据项目内容推断库名（默认仅返回 `{ db }`，可选返回最小化证据统计，不含文件路径/内容）\n- `list_tables(db=None)`：列出库内表（未传 `db` 时使用已推断库或自动选择）\n- `get_table_schema(table, db=None)`：获取表结构（列定义、主键、索引、表注释）\n- `select_rows(table, db=None, columns=None, where=None, order_by=None, limit=100)`：从库表安全查询\n\n### 安全设计\n- 表/列白名单：从 `information_schema` 动态获取并校验\n- 参数化查询：拒绝拼接与多语句\n- 限流：默认 `LIMIT 100`，最大 `LIMIT 1000`\n- 隐私：推断时不回传文件路径/内容；如需证据仅返回脱敏统计\n- 凭据隔离：项目配置只在 MCP 进程内部读取，工具响应仅包含连接状态、项目类型和数据库名\n\n### 在 Cursor 中配置\n在 Cursor 的设置中添加 MCP Server，示例（仅示意，不包含本地路径）：\n\n```json\n{\n  \"mcpServers\": {\n    \"yooztech_mcp_mysql\": {\n      \"command\": \"yooztech_mcp_mysql\",\n      \"args\": [],\n      \"env\": {\n        \"DB_HOST\": \"127.0.0.1\",\n        \"DB_PORT\": \"3306\",\n        \"DB_USER\": \"mcp_tool\",\n        \"DB_PASS\": \"<your-strong-pass>\"\n      }\n    }\n  }\n}\n```\n\n说明：\n- 以上配置假设你已通过包管理器安装本工具（例如 `pip install yooztech_mcp_mysql`），从而可直接使用控制台脚本 `yooztech_mcp_mysql`。\n- 若使用其他运行方式（如 uvx/容器），仅需将 `command` 与 `args` 改为相应启动方式即可，但不要在 README 中暴露你的本地路径。\n\n### 使用 uvx 方式（推荐，免安装）\n如希望在不全局安装包的情况下运行，可在 Cursor 中使用 `uvx`：\n\n```json\n{\n  \"mcpServers\": {\n    \"yooztech_mcp_mysql\": {\n      \"command\": \"uvx\",\n      \"args\": [\"yooztech_mcp_mysql\"],\n      \"env\": {\n        \"DB_HOST\": \"127.0.0.1\",\n        \"DB_PORT\": \"3306\",\n        \"DB_USER\": \"mcp_tool\",\n        \"DB_PASS\": \"<your-strong-pass>\"\n      }\n    }\n  }\n}\n```\n\n提示：确保系统已安装 `uv`/`uvx`。企业私有镜像可通过 `UV_INDEX`/`--index-url` 进行加速配置。\n\n### 环境变量\n- `DB_HOST`：数据库地址\n- `DB_PORT`：数据库端口\n- `DB_USER`：数据库只读账号（最小权限）\n- `DB_PASS`：数据库密码\n\n推荐在数据库中为该工具创建最小权限账号（示例）：\n\n```sql\nCREATE USER 'mcp_tool'@'10.0.%' IDENTIFIED BY '<your-strong-pass>';\nGRANT SELECT ON *.* TO 'mcp_tool'@'10.0.%';\nFLUSH PRIVILEGES;\n```\n\n如需进一步收紧权限，可按库或表粒度授予 `SELECT`。\n\n### 使用建议（在 MCP 客户端中调用）\n- 如项目自带数据库配置，先调用 `connect_project_database(pr…","publisher":{"name":"yooztech","url":null},"homepage":null,"repository":null,"version":"0.1.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:yooztech-mcp-mysql","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":"yooztech-mcp-mysql","registry":"pypi","observedAt":"2026-09-10T16:24:27.670Z","publishedAt":"2026-08-03T05:34:45.309645Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yooztech-mcp-mysql","url":"https://pypi.org/project/yooztech-mcp-mysql/","firstSeenAt":"2026-09-10T16:23:24.235Z","fetchedAt":"2026-09-10T16:23:24.235Z","normalizedAt":"2026-09-10T16:23:24.235Z"}]},"firstSeenAt":"2026-09-10T16:23:24.235Z","updatedAt":"2026-09-10T16:24:27.670Z"}