HumanPen

humanpen-mcp

Inglês · 简体中文 · 日本語

Site · Preços · Documentação do desenvolvedor

Palavras-chave: 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

Humanize o que foi sinalizado. Preserve o restante. Um servidor MCP para HumanPen — um humanizador de IA em nível de documento que pode humanizar um documento inteiro, reescrever trechos selecionados pelo usuário ou direcionar automaticamente o texto sinalizado de um relatório de detecção de IA do Turnitin / iThenticate, editando arquivos .docx / .pptx no local, preservando formatação, tabelas, imagens, citações e fórmulas. Também converte citações entre 12 estilos, condensa para um orçamento de palavras e traduz entre 12 idiomas.

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

Recursos

• Reescrita seletiva por relatório de detecção — importe um Relatório de Escrita de IA do Turnitin / iThenticate para identificar trechos sinalizados; o conteúdo não sinalizado nunca é tocado
• Formato entra, formato sai — um DOCX retorna como DOCX, um PPTX como PPTX; formatação, tabelas, imagens e fórmulas permanecem intactas e o resultado ainda é editável
• Estrutura acadêmica preservada — citações no texto, listas de referências, notas de rodapé, campos de sumário, referências cruzadas, numeração de figuras, equações e formatação especial são tratados como objetos protegidos
• Sem injeção de erros — reestrutura significado e sintaxe para mudar a expressão; nunca adiciona erros de gramática, erros de ortografia ou frases estranhas como estratégia de detecção
• Documentos de tamanho completo — sem limite de palavras por entrada; um único arquivo pode ter até 100 MB, sem divisão em caixas de texto
• Grátis para continuar — ainda sinalizado? Re-humanize gratuitamente com um novo relatório até que a taxa de IA caia para * ou 0%
• Controle de contagem de palavras (experimental) — defina um intervalo mínimo/máximo de palavras para manter a saída dentro de um comprimento alvo
• Pague por reescrita — cobrado pelas palavras realmente alteradas, não pelo documento inteiro; trabalhos falhos e cancelados não custam nada; os créditos nunca expiram

Obtenha uma chave

Cadastre-se em https://humanpen.net e crie uma chave em https://humanpen.net/settings/api-keys. Novas contas começam com créditos gratuitos, suficientes para enviar um documento e ver o que retorna.

A chave vai em uma variável de ambiente, nunca em uma URL. URLs acabam em logs de servidor, logs de proxy, histórico de shell e capturas de tela.

Instalação

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

Qualquer cliente MCP funciona: este é um servidor stdio simples iniciado por npx -y humanpen-mcp com HUMANPEN_API_KEY em seu ambiente.

Ferramentas

Duas coisas que valem a pena saber

Os trabalhos levam minutos; as chamadas de ferramenta não. Cada operação espera cerca de 55 segundos — o suficiente para a maioria dos documentos — e então retorna um job_id com uma nota para chamar check_job. O trabalho continua no servidor de qualquer forma; nada é perdido pela ferramenta retornar cedo.

ai_percent pode ser null, e isso geralmente é uma boa notícia. O Turnitin imprime * em vez de um número sempre que a escrita de IA fica abaixo de 20% — ele não quantifica essa faixa, porque muito dela é falso positivo. Então null significa "abaixo de 20%, e o Turnitin não dirá mais nada", nunca "0%" e nunca "sem resultado".

Perguntas que as pessoas fazem

Isso reduzirá a pontuação de IA do Turnitin? Geralmente abaixo de 20% em uma passada com balanced — o limite abaixo do qual o Turnitin imprime * em vez de um número. Se falhar, devolva o resultado com o novo relatório; apenas os trechos ainda sinalizados são reescritos.

Funciona também com o iThenticate? Sim — envie qualquer um dos relatórios. O formato é lido do arquivo.

Meu documento é enviado ao modelo? Não. Ele envia o arquivo e responde com um caminho. Um artigo de 40 páginas não custa tokens.

Política de Privacidade

Os documentos que você passa para uma ferramenta são enviados via HTTPS para a API do HumanPen (api.humanpen.net) para processamento; os resultados são gravados de volta no seu disco, e os arquivos processados são mantidos no servidor por cerca de 7 dias para que check_job e a passada gratuita de re-humanização possam encontrá-los. O conteúdo dos documentos nunca entra no contexto do modelo. A política completa — o que é coletado, retenção e como nos contatar — está em https://humanpen.net/legal/privacy.

Desenvolvimento

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

selftest.mjs inicia o servidor compilado e fala JSON-RPC com ele via stdio como um cliente real faz — provando o protocolo, os registros de ferramentas, a higiene do stdout e um trabalho de ponta a ponta, não apenas que as funções retornam. Ele precisa de uma chave ativa e gasta créditos, então é uma verificação de pré-lançamento em vez de uma etapa de CI.

Links

• Documentação da API · Esquema OpenAPI
• humanpen-skill — as mesmas operações como uma Skill de Agente, se você preferir não executar um servidor
• humanpen.net

Apache-2.0