matetools

@mate-tools/mcp-server

面向 mate.tools 的模型上下文协议服务。为 AI Agent 提供 35 种实用工具，涵盖文本分析、编码、哈希、密码生成、JSON/CSV/XML/站点地图解析、正则表达式、颜色、日期、金融、URL 元数据提取、SEO 元标签生成、文本清理、CSPRNG 随机生成器、话题标签工具、DNS 查询、SSL/TLS 证书检查、JWT 解码等。它封装了 mate.tools 的公开 JSON API，因此 Claude Desktop、Claude Code、Cursor、Windsurf 及其他任何兼容 MCP 的客户端都能直接调用这些工具。

零依赖 · 免费 · 无需 API 密钥 · 开放 CORS · Node 18+

快速安装

将以下内容添加到 Claude Desktop / Claude Code / Cursor / Windsurf 配置中：

{
  "mcpServers": {
    "mate-tools": {
      "command": "npx",
      "args": ["-y", "@mate-tools/mcp-server"]
    }
  }
}

重启客户端，所有 35 种工具就会出现在选择器中。就是这么简单。

全部 35 种工具，按类别划分

文本（8 种）

工具	功能
count_lines	16 项文本指标：行数、词数、句子数、段落数、字符数、重复项、换行符（LF/CRLF/CR）、最长单词、阅读和朗读时间。
case_convert	一次调用即可将文本转换为 9 种大小写样式：大写、小写、标题式、句首大写、蛇形、短横线、驼峰、帕斯卡、常量式。
slugify	将任意文本转换为适用于 URL 的 slug。支持 Unicode，可配置分隔符和长度，还可选择将非拉丁字符转写为拉丁字符。
sort_lines	对行排序：升序/降序、区分大小写、去重、自然排序（line2 排在 line10 前）、支持区域设置的排序规则。
lorem_ipsum	生成占位文本——段落、句子或单词。
regex_test	使用 PCRE 正则表达式匹配 / 替换 / 拆分文本。返回捕获组偏移量。防止 ReDoS。
text_diff	按行、单词或字符比较两个字符串。返回结构化变更、统一差异字符串和 Jaccard 相似度。
text_cleanup	链式清理流程：修剪、合并空格、去除重复行、移除 HTML/表情符号/URL/电子邮件、规范化引号/破折号、转换为小写/大写。

编码（4 种）

工具	功能
base64_encode	对文本进行 Base64 编码。支持标准或 URL 安全字母表（RFC 4648 §5）。
base64_decode	对 Base64 解码。自动修复缺失的填充；如果结果不是有效的 UTF-8，则返回十六进制。
url_encode	对字符串进行百分号编码。支持组件 / 表单 / 路径模式。
url_decode	解码经过百分号编码的 URL 字符串。

加密与身份验证（5 种）

工具	功能
hash	MD5、SHA-1、SHA-256、SHA-384、SHA-512、SHA3-256、SHA3-512、CRC32（或 PHP 哈希算法的任意子集）。
password	生成密码学安全的随机密码（CSPRNG）。可配置长度、数量、字符类别，并排除易混淆字符。报告熵值。
password_strength	为密码评分（0–4，类似 zxcvbn），并提供熵位数、离线 GPU 破解时间估算、问题和建议。
credit_card_validate	Luhn 校验 + 卡组织识别（Visa、MC、Amex、Discover、JCB、Diners、UnionPay、Maestro、RuPay）。PAN 不会被记录。
jwt_decode	解码 JWT——包括标头、载荷和过期状态。使用密钥验证 HS256/384/512，或使用 PEM 公钥验证 RS256/384/512。Token 不会被记录。

数据与结构（13）

工具	功能
json_format	验证、格式化、压缩或分析 JSON 文档。返回结构摘要（节点数量、最大深度、顶层键）。
json_to_csv	将 JSON 对象数组转换为 CSV。可配置分隔符、列，并可选择扁平化嵌套对象（meta.city、meta.zip）。
xml_validate	验证 XML 格式是否良好，并可选择使用 XSD 架构验证。错误信息包含行号和列号。可防范 XXE。
sitemap_extract	获取并解析 XML 站点地图。可防范 SSRF（拒绝私有、环回、链路本地和云元数据 IP）。可选择递归展开子站点地图。
stats	计算数字列表的描述性统计数据：均值 / 中位数 / 众数 / 标准差 / 方差 / 百分位数 / 四分位距 / 几何平均数 / 调和平均数。
number_base	在 2..36 进制之间转换整数，也支持罗马数字。通过 GMP 安全处理大整数。
finance_calc	多模式财务计算：贷款、复利、单利、折扣、小费、销售税、投资回报率、百分比、加价。
aspect_ratio	根据宽度 × 高度计算最简宽高比（16:9、4:3、21:9 等），或按目标宽高比缩放尺寸。
color_convert	将任意颜色转换为 hex / rgb / rgba / hsl / hsv / cmyk，并提供最接近的命名颜色以及 WCAG 亮度和对比度（AA / AAA 标记）。
url_metadata	获取 URL 并提取标题 / 描述 / OpenGraph / Twitter Card / 规范链接 / 语言 / hreflang / JSON-LD / favicon / 响应头 / 元素数量。可防范 SSRF，内容上限为 2 MB。
meta_tags_generate	根据标题 / 描述 / url / 图片生成完整的 HTML head 区块（meta + OpenGraph + Twitter Card + JSON-LD）。返回可直接粘贴的 HTML，以及 0-100 的 SEO 评分和具体警告。
dns_lookup	通过系统解析器解析 DNS 记录（A、AAAA、MX、TXT、NS、CNAME、SOA、CAA、PTR、SRV）。包含 A 记录的反向 PTR 查询。
ssl_check	检查域名的 TLS 证书：主题、颁发者、有效期、指纹、备用名称、完整证书链、剩余天数、协商的协议 / 密码套件。可防范 SSRF。

日期与时间（3）

工具	功能
timestamp	在 epoch ↔ ISO 8601 ↔ RFC 3339 ↔ 人类可读格式之间双向转换。自动检测 epoch 精度。支持时区。接受自然语言（"next monday"、"+2 weeks"）。
date_math	对日期加上或减去一段时长，或计算两个日期之间的差值。可选择计算工作日（周一至周五）。
age_calc	根据出生日期计算年龄（年 / 月 / 日）。返回下一个生日、距离生日的天数、西方星座和世代标签。

生成器与社交媒体（2）

工具	功能
random_gen	基于 CSPRNG 的生成器：数字、字符串（字母 / 字母数字 / 数字 / 十六进制 / base58 / base64url）、单词、选择器（有放回 / 无放回）、团队分组器、骰子（NdM）、硬币、国家、UUID v4 / v7。
hashtag_tools	对文本中的话题标签进行操作：提取（含偏移量）、移除、生成（按过滤停用词后的词频生成）、格式化（驼峰 / 蛇形 / 小写 / 保留原样）。支持 Unicode。

工具目录会持续扩充。npx -y 始终获取最新发布版本；客户端只需重启即可使用新工具。

各主流客户端的安装配置片段

Claude Desktop

打开 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

添加上方快速安装中的 mcpServers 配置项，然后重启。

Claude Code

claude mcp add mate-tools npx -- -y @mate-tools/mcp-server

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "mate-tools": {
      "command": "npx",
      "args": ["-y", "@mate-tools/mcp-server"]
    }
  }
}

Windsurf 和其他 MCP 客户端

该服务通过标准 JSON-RPC 2.0 帧格式，使用 stdio 与 MCP 通信。任何兼容 MCP 的客户端都可以按照相同的配置格式将其作为子进程启动。

手动安装（不使用 npx）

npm install -g @mate-tools/mcp-server
mate-tools-mcp   # speaks JSON-RPC over stdio; plug into a client

如何验证是否正常工作

安装后，向你的 AI Agent 询问以下任意问题，以确认工具已接入：

“使用 mate-tools 统计这段文字的行数和阅读时间。”

“用 SHA-256 对字符串 secret 进行哈希。”

“生成 10 个高强度密码，长度为 20 个字符，且不包含易混淆字符。”

“评估这个密码的强度：correct horse battery staple。”

“将 #ff5733 转换为所有颜色空间，并告诉我它与白色的 WCAG 对比度。”

“3840 × 2160 的宽高比是多少？”

“帮我对比这两段文字的差异。”

“一笔 30 万美元的贷款，年利率为 6.5%，期限为 30 年，每月还款额是多少？”

“1990-04-15 出生的人多大了？他们的星座是什么？”

“递归提取 https://example.com/sitemap.xml 中的所有 URL。”

“帮我获取 https://example.com 的元数据和 OpenGraph 标签。”

“为标题为 … 的文章生成 SEO 元标签并评估结果。”

“帮我掷六次 4d6，每次去掉最低点数。”

“为这段配文推荐主题标签。”

“查询 example.com 的 MX 和 TXT 记录。”

“github.com 上的 SSL 证书有效吗？何时过期？”

“解码这个 JWT，并告诉我它是否已过期。”

Agent 会自动选择合适的工具。

工作原理

该服务是一个约 600 行、无依赖的 Node 脚本。每次调用工具时：

1. 从 MCP 客户端接收 JSON-RPC tools/call 请求。
2. 将参数转发到公开的 mate.tools API：https://mate.tools/api/v1/{tool}.php。
3. 将易读摘要和完整 JSON 响应返回给客户端。

除 JSON-RPC 通信处理外，其他操作都不会在本地运行。计算由 Cloudflare 后方的 mate.tools 服务执行。每个端点的速率限制为每个 IP 每分钟 60 次请求、每小时 600 次请求。

配置

覆盖 API 端点（例如，针对暂存部署进行测试）：

MATE_TOOLS_API_BASE=https://staging.mate.tools/api/v1 npx -y @mate-tools/mcp-server

隐私

每次工具调用：

• ✅ 仅发送你提供给 MCP 工具的参数。
• ✅ 传输过程使用 HTTPS。
• ✅ 在内存中处理，不会记录内容。
• ❌ 不收集遥测数据。
• ❌ 无需账户、API 密钥或登录。

mate.tools 服务仅记录请求方法、哈希后的 IP（每日轮换盐值）、端点名称和耗时，不会记录请求内容。

credit_card_validate 和 password_strength 经过专门设计，可确保敏感输入不会离开请求处理器的内存。返回的只有验证结果和指标。

sitemap_extract、url_metadata 和 ssl_check 会拒绝获取或连接到名称解析为私有（RFC 1918）、回环、链路本地或云元数据 IP 的任何主机。对于基于 HTTP 的工具，每个重定向目标都会重新验证，因此无法通过 302 重定向利用 SSRF。url_metadata 还会将响应正文限制为 2 MB。ssl_check 使用 5 秒连接超时。

jwt_decode 绝不会记录令牌。解码完全在请求处理器内存中运行；每日访问日志只会记录算法名称、签名验证结果和请求耗时。可放心使用生产环境令牌。

regex_test 会对每个请求强制设置 PCRE 回溯上限（100,000 步）——遇到可能导致灾难性回溯的正则表达式时，会返回明确的 422 响应，而不会让服务挂起。

random_gen 使用 PHP 的 random_int / random_bytes（CSPRNG）生成随机数，不会使用梅森旋转算法。UUID 为符合 RFC 4122 的 v4 版本（含正确的版本和变体位），或带毫秒精度时间戳的 v7 版本。

源代码和文档

• npm： https://www.npmjs.com/package/@mate-tools/mcp-server
• 源代码（单文件）： https://mate.tools/api/mcp/server.js
• 安装指南（含屏幕截图）： https://mate.tools/api/mcp
• JSON API 参考： https://mate.tools/api
• OpenAPI 3.1 规范： https://mate.tools/api/openapi.json
• llms.txt： https://mate.tools/llms.txt

问题 / 反馈

请通过 mate.tools 联系表单 提交问题 — 请在主题行中注明 "@mate-tools/mcp-server"。大约每 1–2 周会推出新工具；如果你想要接入某个特定实用工具，尽管提出。

许可证

MIT — 可免费用于个人和商业用途。请参阅 LICENSE。