yooztech_mcp_mysql Logo

yooztech_mcp_mysql

Official

Enables secure read-only access to MySQL databases with automatic database inference from project co...

13 views
0 installs
Updated Jan 30, 2026
Not audited
Tools I Recommend
Enables secure read-only access to MySQL databases with automatic database inference from project context. Provides safe querying capabilities with built-in security features like parameterized queries, whitelisting, and rate limiting.
  1. 打开 FastMCP 连接界面并点击 “Install Now”
    在 FastMCP 的连接界面中使用已准备好的 “Install Now” 按钮开始添加环境变量(ENVs)。你将在该界面看到可以填写环境变量的表单字段 —— 接下来的值都要填写到那里。

  2. 准备 DB_HOST(数据库地址)

    • 本地 MySQL:填写 127.0.0.1localhost(如果 FastMCP 与数据库在同一台机器或通过本地端口转发)。
    • 云数据库(RDS/Cloud SQL/Azure 等):在云控制台找到实例的连接端点(endpoint / hostname),将该值填写为 DB_HOST(示例:mydb.xxxxxx.region.rds.amazonaws.com)。
    • 容器/私有网络:填写容器或内网的 IP/主机名;若通过 SSH 隧道或端口映射,填写隧道本地监听地址(例如 127.0.0.1)和映射端口。
      将得到的主机名或 IP 填到 FastMCP 表单的 DB_HOST 字段。
  3. 确认 DB_PORT(数据库端口)

    • 默认 MySQL 端口为 3306。若数据库使用自定义端口,请在云控制台/数据库配置中查到实际端口并填写到 DB_PORT 字段。
    • 示例:DB_PORT = 3306
  4. 准备 DB_USER 和 DB_PASS(只读账号与密码)

    • 推荐创建最小权限的只读账号。示例 SQL(在数据库管理员账户下运行):
      CREATE USER 'mcp_tool'@'10.0.%' IDENTIFIED BY '<your-strong-pass>';
      GRANT SELECT ON *.* TO 'mcp_tool'@'10.0.%';
      FLUSH PRIVILEGES;
      
      • <your-strong-pass> 替换为强密码。若 FastMCP 从公网连接,改用合适的主机匹配(例如具体 IP 或 '%)并结合防火墙规则。
      • 如需更严格权限,按库/表粒度只授予 SELECT(例如 GRANT SELECT ON mydb.* TO ...)。
    • 在 FastMCP 表单中将用户名填写到 DB_USER,密码填写到 DB_PASS。
  5. 生成与保存强密码

    • 使用密码管理器生成长度足够且随机的密码(例如 16+ 字符,包含大小写/数字/符号)。
    • 将密码安全地保存到你的密码管理器;不要在 README 或代码仓库中明文提交密码。
  6. 确保网络/防火墙允许连接

    • 在数据库服务器或云控制台中,将运行 FastMCP 的主机或 IP 列入允许连接的白名单(安全组、防火墙规则)。
    • 如果不便开放端口,考虑使用 SSH 隧道或将 FastMCP 部署在与数据库同一私有网络中。
  7. 本地测试连接(可选,但强烈建议)

    • 在可以访问数据库的主机上用 mysql 客户端测试:
      mysql -h <DB_HOST> -P <DB_PORT> -u <DB_USER> -p
      
      然后输入密码并执行 SELECT 1;SHOW DATABASES; 验证只读账号可用且权限正确。
  8. 在 FastMCP 连接界面填写并保存 ENV 值

    • 把上面准备好的值填写到对应字段:
      • DB_HOST: <你的数据库地址>
      • DB_PORT: <端口,通常 3306>
      • DB_USER: <只读用户名,如 mcp_tool>
      • DB_PASS: <对应密码>
    • 点击保存/安装(Install Now 完成后按界面提示保存配置)。
  9. 在 FastMCP 中验证 MCP 功能(运行最小查询)

    • 在 FastMCP/客户端里调用本工具的轻量操作(例如 list_databases() 或 infer_database())确认能正常列出数据库或返回推断结果。若报网络/认证错误,回到上述步骤检查主机、端口、防火墙与用户名/密码。
  10. 安全建议与维护

    • 使用最小权限原则:只授予必要的 SELECT 权限,按库或表细化。
    • 定期轮换 DB_PASS 并更新 FastMCP 配置。
    • 如果可能,限制 mcp_tool 的连接来源 IP,并启用连接监控与审计。

Quick Start

View on GitHub

More for Database

View All →

Similar MCP Servers

Report Issue

Thank you! Your issue report has been submitted successfully.