HumanPen

humanpen-mcp

Español · 简体中文 · 日本語

Sitio web · Precios · Documentación para desarrolladores

Palabras clave: ai humanizer, mcp server, model context protocol, turnitin ai detection, reduce ai score, humanize ai text, bypass ai detection, docx ai humanizer, ai content rewriter, ai writing tool, claude mcp, cursor mcp, ithenticate ai report

Humaniza lo que está marcado. Preserva el resto. Un servidor MCP para HumanPen — un humanizador de IA a nivel de documento que puede humanizar un documento completo, reescribir pasajes seleccionados por el usuario, o apuntar automáticamente a texto marcado en un informe de detección de IA de Turnitin / iThenticate, editando archivos .docx / .pptx en el lugar mientras preserva formato, tablas, imágenes, citas y fórmulas. También convierte citas entre 12 estilos, condensa a un presupuesto de palabras y traduce entre 12 idiomas.

claude mcp add humanpen -s user -e HUMANPEN_API_KEY=hp_your_key -- npx -y humanpen-mcp

Características

• Reescritura selectiva mediante informe de detección — importe un informe de escritura con IA de Turnitin / iThenticate para localizar pasajes marcados; el contenido no marcado nunca se toca
• Formato de entrada, formato de salida — un DOCX vuelve como DOCX, un PPTX como PPTX; el formato, tablas, imágenes y fórmulas sobreviven intactos y el resultado sigue siendo editable
• Estructura académica preservada — citas en el texto, listas de referencias, notas al pie, campos de TOC, referencias cruzadas, numeración de figuras, ecuaciones y formato especial se tratan como objetos protegidos
• Sin inyección de errores — reestructura significado y sintaxis para cambiar la expresión; nunca añade errores gramaticales, ortográficos o frases incómodas como estrategia de detección
• Documentos de longitud completa — sin límite de palabras por entrada; un solo archivo puede tener hasta 100 MB, sin dividir en cajas de texto
• Gratis para seguir — ¿aún marcado? Re-humanice gratis con un informe nuevo hasta que la tasa de IA baje a * o 0%
• Control de recuento de palabras (experimental) — establezca un rango mínimo/máximo de palabras para mantener la salida dentro de una longitud objetivo
• Pague por reescritura — se facturan las palabras realmente modificadas, no todo el documento; los trabajos fallidos y cancelados no cuestan nada; los créditos nunca expiran

Obtenga una clave

Regístrese en https://humanpen.net y cree una clave en https://humanpen.net/settings/api-keys. Las cuentas nuevas comienzan con créditos gratuitos, suficientes para procesar un documento y ver qué resulta.

La clave va en una variable de entorno, nunca en una URL. Las URLs terminan en registros de servidor, registros de proxy, historial de shell y capturas de pantalla.

Instalación

claude mcp add humanpen -s user -e HUMANPEN_API_KEY=hp_your_key -- npx -y humanpen-mcp

claude mcp add-json humanpen -s user '{"command":"npx","args":["-y","humanpen-mcp"],"env":{"HUMANPEN_API_KEY":"hp_your_key"}}'

[mcp_servers.humanpen]
command = "npx"
args = ["-y", "humanpen-mcp"]
env = { HUMANPEN_API_KEY = "hp_your_key" }

codebuddy mcp add --scope user humanpen -- npx -y humanpen-mcp

{ "mcpServers": { "humanpen": {
  "command": "npx", "args": ["-y", "humanpen-mcp"],
  "env": { "HUMANPEN_API_KEY": "${HUMANPEN_API_KEY}" }
} } }

{
  "mcpServers": {
    "humanpen": {
      "command": "npx",
      "args": ["-y", "humanpen-mcp"],
      "env": { "HUMANPEN_API_KEY": "hp_your_key" }
    }
  }
}

{
  "mcpServers": {
    "humanpen": {
      "command": "npx",
      "args": ["-y", "humanpen-mcp"],
      "env": { "HUMANPEN_API_KEY": "hp_your_key" }
    }
  }
}

{
  "mcp": {
    "humanpen": {
      "type": "local",
      "command": ["npx", "-y", "humanpen-mcp"],
      "environment": { "HUMANPEN_API_KEY": "hp_your_key" }
    }
  }
}

{
  "mcp": {
    "inputs": [
      { "type": "promptString", "id": "humanpenKey", "description": "HumanPen API key", "password": true }
    ],
    "servers": {
      "humanpen": {
        "command": "npx",
        "args": ["-y", "humanpen-mcp"],
        "env": { "HUMANPEN_API_KEY": "${input:humanpenKey}" }
      }
    }
  }
}

git clone https://github.com/humanpen/humanpen-mcp
cd humanpen-mcp && npm install && npm run build

Cualquier cliente MCP funciona: este es un servidor stdio simple iniciado por npx -y humanpen-mcp con HUMANPEN_API_KEY en su entorno.

Herramientas

Dos cosas que vale la pena saber

Los trabajos toman minutos; las llamadas a herramientas no. Cada operación espera unos 55 segundos — suficiente para la mayoría de documentos — luego devuelve un job_id con una nota para llamar a check_job. El trabajo continúa en el servidor de todos modos; nada se pierde porque la herramienta regrese temprano.

ai_percent puede ser null, y eso suele ser una buena noticia. Turnitin imprime * en lugar de un número siempre que la escritura con IA esté por debajo del 20% — no cuantificará ese rango, porque demasiado de eso son falsos positivos. Así que null significa "por debajo del 20%, y Turnitin no dirá más", nunca "0%" ni "sin resultado".

Preguntas que la gente hace

¿Esto reducirá una puntuación de IA de Turnitin? Generalmente por debajo del 20% en una pasada con balanced — el umbral por debajo del cual Turnitin imprime * en lugar de un número. Si falla, entregue el resultado de nuevo con el nuevo informe; solo se reescriben los pasajes aún marcados.

¿También funciona con iThenticate? Sí — pase cualquiera de los dos informes. El formato se lee del archivo.

¿Mi documento se envía al modelo? No. Sube el archivo y responde con una ruta. Un artículo de 40 páginas no cuesta tokens.

Política de privacidad

Los documentos que pase a una herramienta se suben por HTTPS a la API de HumanPen (api.humanpen.net) para procesarse; los resultados se escriben en su disco, y los archivos procesados se mantienen en el servidor durante unos 7 días para que check_job y la pasada gratuita de re-humanización puedan encontrarlos. El contenido de los documentos nunca entra en el contexto del modelo. La política completa — qué se recopila, retención y cómo contactarnos — está en https://humanpen.net/legal/privacy.

Desarrollo

npm install
npm run build
HUMANPEN_API_KEY=hp_... node selftest.mjs sample.docx report.pdf

selftest.mjs inicia el servidor compilado y habla JSON-RPC con él a través de stdio de la manera que lo hace un cliente real — probando el protocolo, los registros de herramientas, la higiene de stdout y un trabajo de extremo a extremo, no solo que las funciones regresan. Necesita una clave activa y gasta créditos, por lo que es una verificación previa al lanzamiento y no un paso de CI.

Enlaces

• Documentación de la API · Esquema OpenAPI
• humanpen-skill — las mismas operaciones como una habilidad de agente, si prefiere no ejecutar un servidor
• humanpen.net

Apache-2.0