humanpen-mcp 是基于 Model Context Protocol (MCP) 的服务器，封装了 HumanPen 的文档级 AI 文本人性化能力。它面向需要处理学术或专业文档、并希望降低 AI 检测率的用户。
主要能力：
- 人性化整份 .docx 或 .pptx 文档，无需拆分文本框；单文件最大 100 MB，无单次输入字数限制。
- 重写用户选中的段落，或根据 Turnitin / iThenticate 报告自动定位并只改写被标记的文本，未标记内容不会被修改。
- 原地编辑并保留原格式：格式、表格、图片、公式、文内引用、参考文献列表、脚注、目录域、交叉引用、图表编号、方程和特殊格式均被视为受保护对象。
- 支持 12 种引用格式互相转换、按字数预算压缩至目标长度以及 12 种语言互译。
- 不采用注入错误策略（不添加语法或拼写错误、不制造别扭句子），而是通过重组语义和句法来改变表达。
- 按实际改写的字数计费，失败与取消的任务不扣费，积点不过期。若仍被标记，可凭新报告免费重新人性化，直到 AI 率降至 * 或 0%。
- 提供实验性字数控制功能，可设置最小/最大字数范围以约束输出长度。
使用方式： 在 https://humanpen.net 注册，并在 https://humanpen.net/settings/api-keys 创建 API Key。新账户附带免费积点，足以完成一份文档的体验。API Key 应放在环境变量中（切勿写入 URL，以免泄露到服务器日志、代理日志、shell 历史或截图中）。 作为 stdio 服务器运行，通过 npx 启动：npx -y humanpen-mcp，并在环境中提供 HUMANPEN_API_KEY。支持任意 MCP 客户端，包括 Claude Code、Codex、CodeBuddy、Gemini CLI、Claude Desktop、Cursor、Windsurf、Cline、opencode、VS Code 等。不同客户端的配置方式与范围（local / user / project）略有差异，需参考各自文档。若客户端版本拒绝 -e 参数，可使用 JSON 形式的配置。也可本地构建后，将客户端指向 node /path/to/humanpen-mcp/dist/index.js。
适用场景： 适合处理学术论文、报告、演示文稿等需要保留复杂格式的文档，并希望降低 AI 检测率的用户，尤其适用于收到 Turnitin / iThenticate 标记后需要精准重写的场景。
限制与注意事项： 每个操作工具调用大约等待 55 秒，随后返回 job_id，需要调用 check_job 继续查询；作业在服务器端继续运行，不会丢失。ai_percent 可能为 null，这通常意味着 Turnitin 显示 *（AI 写作低于 20% 时不显示具体数值），并非 0% 或没有结果。文档会通过 HTTPS 上传至 api.humanpen.net 处理，结果写回本地磁盘，处理后的文件在服务器端保留约 7 天，以便 check_job 和免费重新人性化使用；文档内容不会进入模型上下文。如需了解数据收集、保留政策，请访问 https://humanpen.net/legal/privacy。提供 selftest.mjs 作为发布前自检，需要有效 Key 且会消耗积点。另有 humanpen-skill 以 Agent Skill 形式提供相同操作。定价、详细价格与开发者文档请查阅官网。