AIHumanly MCP 服务
将 AIHumanly 的人性化工具直接集成到您的 AI 编程助手中。Codex、Claude Code、TRAE、Cursor —— 一个 URL 即可全部连接。让您的 AI 工具像调用本地函数一样进行文本人性化。
概述
AIHumanly MCP（Model Context Protocol）服务允许您将 AIHumanly 的人性化能力直接集成到 AI 编程助手（如 Codex、Claude Code、TRAE、Cursor 等）中。AI 编程助手可以像调用本地工具一样轻松调用人性化功能 —— 就像 AI 工具的通用 USB 接口一样。任何兼容 MCP 的 AI 工具只需一个 URL 即可连接。
快速开始
1. 获取您的 API Key
访问 aihumanly.io，注册或登录后，从您的仪表盘获取 API Key（160 位十六进制字符串）。请确保您的账户拥有有效的订阅和可用的字数余额。
2. 配置您的 AI 工具
在下方选择您的 AI 工具并添加 MCP 配置。每种工具有其自己的配置格式 —— 选择您的工具并按照指南操作。
配置指南
选择您的 AI 工具查看配置指南。
可用工具
humanize_text
将 AI 生成的文本转换为更自然、更像人类写作的风格，降低 AI 检测率。
参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| paragraph | string | 是 | 需要转换的原始段落文本（最少 15 个单词）。 |
| lang | string | 是 | 语言代码（例如 en、zh-cn、es、fr、de、jp）。 |
使用示例
在您的 AI 编程助手中，用自然语言描述您想要的："帮我去除这段文本的 AI 痕迹：人工智能已经彻底改变了我们与技术互动的方式。" 助手将自动调用 humanize_text 工具并返回人性化后的结果。
技术架构
MCP 如何将您的 AI 编程工具连接到 AIHumanly 的人性化引擎。
AI 编程助手
Codex、Claude Code、TRAE、Cursor —— 您的 AI 工具发送自然语言请求。
MCP 协议
基于 SSE 的 JSON-RPC 2.0 —— 标准化的通信层。
MCP 服务器（桥接）
api.aihumanly.io/mcp —— 处理 SSE 连接、协议转换和身份认证。
AIHumanly 后端
核心人性化引擎 —— 段落转换、重写、词汇替换、AI 检测、相似度评分。
MCP 端点
/mcp/sseSSE 连接端点 —— 建立持久化事件流。
/mcp/messages?sessionId=xxxJSON-RPC 消息端点 —— 发送请求并接收 SSE 响应。
/mcpStreamable HTTP 端点 —— 兼容较新的 MCP 客户端。
支持的 MCP 方法
initialize握手协商 —— 交换客户端/服务器能力。
notifications/initialized客户端初始化完成通知。
tools/list获取可用工具列表。
tools/call调用指定工具。
ping心跳检测。
身份认证
MCP 服务支持两种方式传递您的 API Key：
方法 1：HTTP Header（推荐）
在 MCP 配置中设置 x-api-key 头。也支持标准的 Bearer Token 格式。
"headers": {
"x-api-key": "YOUR_API_KEY"
}方法 2：工具参数
在调用 humanize_text 时将 api_key 作为参数传递。如果两种方法同时使用，Header 优先。
{
"name": "humanize_text",
"arguments": {
"paragraph": "您的文本...",
"lang": "en",
"api_key": "YOUR_API_KEY"
}
}限制与配额
- •每次调用消耗您订阅的字数余额（与 Web 应用共享）。
- •段落必须至少包含 15 个单词。
- •单次请求超时时间：180 秒。
- •API Key 必须关联到有效的订阅。
- •如果字数余额不足，工具调用将返回错误。
常见问题
关于 AIHumanly MCP 服务的常见问题。