HumanTone

humantone-mcp

HumanTone 的官方 Model Context Protocol 服务，适用于 HumanTone。可直接在 Claude Desktop、Cursor、Cline 和其他 MCP 客户端中使用 HumanTone 的文本人性化和 AI 可能性检测工具。只需一个 API 密钥，即可使用你在 HumanTone 网页应用中已有的额度。

HumanTone 是一款 AI 文本人性化工具，可改写 AI 生成的内容，使其读起来更自然。此 MCP 服务将这些工具带入你的 AI 助手。

早期版本（v0.0.x）。在 GitHub 关注更新。

要求

• Node.js 18 或更高版本。
• 拥有 API 访问权限的 HumanTone 付费方案。免费试用账户无法使用 API。
• 从 app.humantone.io/settings/api 获取的 API 密钥。

安装

无需安装。MCP 客户端会在首次启动时通过 npx humantone-mcp 下载软件包。只需添加下方适用于你客户端的配置片段即可。

配置

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": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

编辑文件后，重启 Claude Desktop。

Cursor

通过“设置”中的 MCP 进行配置，或直接编辑 ~/.cursor/mcp.json。

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

编辑配置后，重启 Cursor。

Cline（VSCode 扩展）

通过 Cline“设置”中的 MCP Servers 进行配置，使用相同的代码片段结构：

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

编辑配置后，重启 VSCode。

其他 MCP 客户端

humantone-mcp 适用于任何兼容 MCP 的客户端，包括支持 GitHub Copilot Agent 模式的 VSCode、Codex CLI、Gemini CLI、Continue.dev、Zed、Windsurf、JetBrains AI Assistant 等。所有客户端的配置模式相同：使用命令（npx -y humantone-mcp），并在环境中设置 HUMANTONE_API_KEY。

请参阅 humantone.io/docs/mcp/，了解特定客户端的配置片段和故障排除方法。

工具

• humanize 会改写文本，使其读起来更自然、更像真人撰写。支持为语气、受众和术语设置自定义指令。
• detect_ai 会检测文本由 AI 生成的可能性（0 到 100）。不会消耗额度。每天可检测 30 次，与 HumanTone 网页应用共享次数。
• get_account 会显示当前方案、额度和订阅状态。

使用示例

配置完成后，你可以自然地与助手交流。在消息中提及 humantone 或特定工具名称，有助于模型可靠地调用 MCP 工具。对于人性化改写请求，这一点尤其重要，否则模型可能会自行改写文本。

人性化改写：

• “用 humantone 改写这份草稿，让它读起来更自然：<粘贴你的文本>”
• “用正式的企业语气，通过 humantone 处理这段文字：<粘贴你的文本>”
• “将这段文字交给 humantone，将级别设为 advanced，并保留 Kubernetes 一词不变：<粘贴你的文本>”

检测 AI 可能性：

• “用 humantone 的 AI 检测器为这段文字评分：<粘贴你的文本>”
• “用 humantone 检测 AI 可能性：<粘贴你的文本>”
• “用 humantone detect_ai 处理这段文字：<粘贴你的文本>”

账户状态：

• “我还剩多少 HumanTone 额度？”
• “我当前的 HumanTone 方案是什么？”
• “我的 HumanTone 订阅何时续订？”

故障排除

• 助手中未显示工具。 确认 JSON 配置没有语法错误，然后完全退出并重新打开客户端。仅刷新窗口是不够的。
• 出现“Invalid API key format”错误。 密钥长度为 67 个字符：以 ht_ 开头，后接 64 个十六进制字符。如不确定，请前往 app.humantone.io/settings/api 生成新密钥。
• 出现“Plan does not include API access”错误。 免费试用账户无法使用 API。请在 humantone.io/pricing 查看付费方案。
• 出现“npx: command not found”。 请从 nodejs.org 安装 Node.js 18 或更高版本。

链接

• 更多客户端的 MCP 配置指南：https://humantone.io/docs/mcp/
• API 文档：https://humantone.io/docs/api/
• HumanTone Node SDK（本服务使用）：https://www.npmjs.com/package/humantone
• 获取 API 密钥：https://humantone.io/dashboard/settings/api
• 问题反馈：https://github.com/humantone/humantone-mcp/issues
• 作者邮箱：[email protected]
• 产品支持：[email protected]

许可证

MIT。版权所有 (c) HumanTone。