yhtool-mcp-server

--- tags: - mcp - python - 数据库 - 邮件 - 内容管理 aliases: - yhtool-mcp - 数据库工具 date: 2026-08-05 --- # yhtool MCP Server 使用文档 ## 1. 简介 “一会”工具，让AI干啥都一会。致力成为适配80%工作场景的综合工具。 yhtool MCP Server 是一个 MCP 服务器，提供数据查询，数据保存和邮件发送功能。 **特点：** 1. 节省token，只保留日常使用频率较高的tool，避免启动太多MCP Server，占据太多上下文； 2. 一个基础助手Agent只勾选一个MCP工具，yhtool； 3. 不求最细，但求最全。只追求能覆盖8成工作中的使用最多的场景，剩下2成由其它垂直MCP完成； **核心功能：** - 数据保存到 CSV 文件 - 数据保存到 MySQL 数据库 - 邮件发送功能 - 图片上传获取链接（SM.MS） - 从csv、excel、sql中读取数据 - 查询内容分类提示词和示例API - 写入内容API **拓展功能：** - 高德坐标转换（GPS/百度/图吧 -> GCJ-02） - 天地图地理编码查询（地址 -> CGCS2000坐标，可选转高德） ## 2. 安装配置 ### 前置要求 uv 管理（推荐） **Windows （PowerShell）安装：** ```powershell powershell -c "irm https://astral.sh/uv/install.ps1 | iex" ``` **macOS/Linux 安装：** ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` 验证安装： ```bash uv --version ``` ### MCP 客户端配置 以TRAE为例，点击界面右上⚙️‘设置’，选择‘MCP’，‘添加’，‘手动配置’； 修改下面配置json的环境变量信息，主要是你的数据库连接、邮箱smtp配置、图床key。复制粘贴到配置窗口即可。 在你的 MCP 客户端配置中添加： ```json { "mcpServers": { "yhtool": { "command": "uvx", "args": [ "yhtool-mcp-server" ], "env": { "CONSTR_MYSQL": "mysql+pymysql://user:pass@host:port/database", "EMAIL_PARAMS": "[\"user@example.com\",\"password\",\"smtp.example.com\",587]", "SMMS_KEY": "your-api-key", "CONTENT_URL": "https://your-domain.com", "CONTENT_RULE_ROUTE": "/api/content_example", "CONTENT_ADD_ROUTE": "/api/add_content", "CONTENT_AUTH_USER": "admin", "CONTENT_AUTH_SECRET": "123456", "GD_KEY": "你的高德Web服务Key", "TIANDITU_KEY": "你的天地图Key" } } } } ``` ### 环境变量配置 | 环境变量 | 说明 | 默认值 | | -------------- | ----------------------------------------------- | ------------------------------------------------------------- | | `CONSTR_MYSQL` | MySQL 连接字符串，需要数据库账号； | `mysql+pymysql://user:password@host:port/database` | | `EMAIL_PARAMS` | 邮件参数（JSON 数组）支持SSL587和TLS465两种协议端口；需要在邮箱设置； | `["user@example.com","your-password","smtp.example.com…