humantone-mcp

HumanTone 官方模型上下文协议 (MCP) 服务器。直接从 Claude Desktop、Cursor、Cline 及其他 MCP 客户端使用 HumanTone 的润色和 AI 概率检测工具。使用同一个 API 密钥，并共享您在 HumanTone Web 应用中已有的额度。

HumanTone 是一款 AI 文本润色工具，可重写 AI 生成的内容，使其听起来更自然。此 MCP 服务器将这些工具引入您的 AI 助手。

早期版本 (v0.0.x)。请在 GitHub 上关注更新。

要求

• Node.js 18 或更高版本。

• 具有 API 访问权限的 HumanTone 付费套餐。免费试用账户无法使用 API。

• 从 app.humantone.io/settings/api 获取的 API 密钥。

Related MCP server: PostIdentity MCP Server

安装

无需安装步骤。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 代理模式的 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 Web 应用共享。

• get_account：显示当前套餐、额度和订阅状态。

使用示例

配置完成后，请自然地与您的助手对话。在消息中提及 humantone 或特定的工具名称有助于模型可靠地路由到 MCP 工具，特别是对于模型本身可能会尝试重写文本的润色请求。

润色 (Humanize)：

• “使用 humantone 重写此草稿，使其读起来更自然：<粘贴您的文本>”

• “使用 humantone 以正式的企业语气运行此内容：<粘贴您的文本>”

• “将其传给 humantone，将级别设置为高级，并保持 Kubernetes 术语不变：<粘贴您的文本>”

检查 AI 概率 (Check AI likelihood)：

• “使用 humantone 的 AI 检测器为此段落评分：<粘贴您的文本>”

• “使用 humantone 检查 AI 概率：<粘贴您的文本>”

• “通过 humantone detect_ai 运行此内容：<粘贴您的文本>”

账户状态 (Account status)：

• “我还有多少 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://app.humantone.io/settings/api

• 问题反馈：https://github.com/humantone/humantone-mcp/issues

• 作者邮箱：dev@humantone.io

• 产品支持：help@humantone.io

许可证

MIT。版权所有 (c) HumanTone。