{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_uf5eqhy7twxf","handle":"yhtool-mcp-server","url":"https://wellknown.network/agents/yhtool-mcp-server","links":{"self":"https://wellknown.network/agents/yhtool-mcp-server/record.json","html":"https://wellknown.network/agents/yhtool-mcp-server","markdown":"https://wellknown.network/agents/yhtool-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/yhtool-mcp-server","status":"https://wellknown.network/api/v1/agents/yhtool-mcp-server/status","claim":"https://wellknown.network/agents/yhtool-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yhtool-mcp-server/claim.json","badge":"https://wellknown.network/agents/yhtool-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yhtool-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yhtool-mcp-server","summary":"yhtool MCP Server - '一会‘工具，一会就好。查数据，存数据，发邮件，生成图片链接等；","description":"---\ntags:\n  - mcp\n  - python\n  - 数据库\n  - 邮件\n  - 内容管理\n\naliases:\n  - yhtool-mcp\n  - 数据库工具\n\ndate: 2026-08-05\n---\n\n# yhtool MCP Server 使用文档\n\n## 1. 简介\n“一会”工具，让AI干啥都一会。致力成为适配80%工作场景的综合工具。\n\nyhtool MCP Server 是一个 MCP 服务器，提供数据查询，数据保存和邮件发送功能。\n\n**特点：**\n1. 节省token，只保留日常使用频率较高的tool，避免启动太多MCP Server，占据太多上下文；\n2.  一个基础助手Agent只勾选一个MCP工具，yhtool；\n3. 不求最细，但求最全。只追求能覆盖8成工作中的使用最多的场景，剩下2成由其它垂直MCP完成；\n\n**核心功能：**\n- 数据保存到 CSV 文件\n- 数据保存到 MySQL 数据库\n- 邮件发送功能\n- 图片上传获取链接（SM.MS）\n- 从csv、excel、sql中读取数据\n- 查询内容分类提示词和示例API\n- 写入内容API\n**拓展功能：**\n- 高德坐标转换（GPS/百度/图吧 -> GCJ-02）\n- 天地图地理编码查询（地址 -> CGCS2000坐标，可选转高德）\n\n## 2. 安装配置\n\n### 前置要求\nuv 管理（推荐）\n\n**Windows （PowerShell）安装：**\n```powershell\npowershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n**macOS/Linux 安装：**\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n验证安装：\n```bash\nuv --version\n```\n\n### MCP 客户端配置\n\n以TRAE为例，点击界面右上⚙️‘设置’，选择‘MCP’，‘添加’，‘手动配置’；\n修改下面配置json的环境变量信息，主要是你的数据库连接、邮箱smtp配置、图床key。复制粘贴到配置窗口即可。\n\n在你的 MCP 客户端配置中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"yhtool\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"yhtool-mcp-server\"\n      ],\n      \"env\": {\n        \"CONSTR_MYSQL\": \"mysql+pymysql://user:pass@host:port/database\",\n        \"EMAIL_PARAMS\": \"[\\\"user@example.com\\\",\\\"password\\\",\\\"smtp.example.com\\\",587]\",\n        \"SMMS_KEY\": \"your-api-key\",\n        \"CONTENT_URL\": \"https://your-domain.com\",\n        \"CONTENT_RULE_ROUTE\": \"/api/content_example\",\n        \"CONTENT_ADD_ROUTE\": \"/api/add_content\",\n        \"CONTENT_AUTH_USER\": \"admin\",\n        \"CONTENT_AUTH_SECRET\": \"123456\",\n        \"GD_KEY\": \"你的高德Web服务Key\",\n        \"TIANDITU_KEY\": \"你的天地图Key\"\n      }\n    }\n  }\n}\n```\n\n### 环境变量配置\n\n| 环境变量 | 说明 | 默认值 |\n| -------------- | ----------------------------------------------- | ------------------------------------------------------------- |\n| `CONSTR_MYSQL` | MySQL 连接字符串，需要数据库账号； | `mysql+pymysql://user:password@host:port/database` |\n| `EMAIL_PARAMS` | 邮件参数（JSON 数组）支持SSL587和TLS465两种协议端口；需要在邮箱设置； | `[\"user@example.com\",\"your-password\",\"smtp.example.com…","publisher":null,"homepage":"https://github.com/FullerYu/yhtool-mcp-server","repository":"https://github.com/FullerYu/yhtool-mcp-server","version":"0.1.26080510","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:yhtool-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"productivity.email","name":"Email","confidence":0.745,"provenance":"derived"},{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":0.733,"provenance":"derived"}],"categories":["data","documents","productivity"],"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":"yhtool-mcp-server","registry":"pypi","observedAt":"2026-09-10T16:24:26.343Z","publishedAt":"2026-08-05T08:58:57.913657Z","latestVersion":"0.1.26080510"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yhtool-mcp-server","url":"https://pypi.org/project/yhtool-mcp-server/","firstSeenAt":"2026-09-10T16:23:18.523Z","fetchedAt":"2026-09-10T16:23:18.523Z","normalizedAt":"2026-09-10T16:23:18.523Z"}]},"firstSeenAt":"2026-09-10T16:23:18.523Z","updatedAt":"2026-09-10T16:24:26.343Z"}