humanpen-mcp

humanpen-mcp

English · 简体中文 · 日本語

ウェブサイト · 料金 · 開発者向けドキュメント

キーワード： AI文章の人間らしさ向上、MCP サーバー、モデルコンテキストプロトコル、Turnitin の AI 検出、AI スコアの低減、AI テキストの人間らしさ向上、AI 検出の回避、DOCX の AI 人間らしさ向上、AI コンテンツの書き換え、AI ライティングツール、Claude MCP、Cursor MCP、iThenticate の AI レポート

検出された箇所を人間らしい表現に。ほかの箇所はそのままに。 HumanPen 用の MCP サーバーです。文書全体の表現を人間らしく整えたり、ユーザーが選択した箇所を書き換えたり、Turnitin／iThenticate の AI 検出レポートで検出されたテキストを自動的に対象にしたりできます。.docx／.pptx ファイルを直接編集し、書式、表、画像、引用、数式を保持します。また、引用形式を 12 種類のスタイル間で変換したり、指定した語数に要約したり、12 言語間で翻訳したりできます。

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

特長

• 検出レポートに基づく選択的な書き換え — Turnitin／iThenticate の AI Writing Report を読み込み、検出された箇所を特定します。検出されていない内容には一切手を加えません
• 元の形式を維持 — DOCX は DOCX、PPTX は PPTX のまま出力します。書式、表、画像、数式をそのまま保持し、編集可能な状態を維持します
• 学術文書の構成を保持 — 本文中の引用、参考文献リスト、脚注、目次フィールド、相互参照、図表番号、数式、特殊な書式を保護対象として扱います
• 誤りを意図的に加えない — 意味と構文を組み立て直して表現を変えます。検出回避のために文法ミスやスペルミス、不自然な文を加えることはありません
• 長文書にも対応 — 入力ごとの語数制限はありません。単一ファイルは最大 100 MB まで対応し、テキストボックスに分割する必要もありません
• 何度でも無料で再処理 — まだ検出されますか？ AI 判定率が * または 0% になるまで、新しいレポートを使って無料で再度人間らしい表現にできます
• 語数の調整（実験的機能） — 最小／最大語数を設定して、出力を目標の長さに収められます
• 書き換えた分だけお支払い — 文書全体ではなく、実際に変更した語数に基づいて課金されます。失敗したジョブやキャンセルしたジョブは無料で、クレジットに有効期限はありません

キーを取得する

https://humanpen.net で登録し、 https://humanpen.net/settings/api-keys でキーを作成してください。新しいアカウントには無料クレジットが付与されるため、文書を処理して結果を確認できます。

キーは環境変数に設定し、URL には含めないでください。URL はサーバーログ、プロキシログ、シェルの履歴、スクリーンショットに残る可能性があります。

インストール

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

どのMCPクライアントでも使えます。これは、環境変数HUMANPEN_API_KEYを設定してnpx -y humanpen-mcpで起動する、通常のstdioサーバーです。

ツール

知っておくとよいこと

ジョブには数分かかりますが、ツール呼び出しにはかかりません。 各操作は約55秒待機します ――ほとんどの文書には十分な時間です――その後、check_jobを呼び出すよう案内するメモとともに job_idを返します。どちらの場合も処理はサーバー上で続行されるため、ツールが早く応答しても 処理が失われることはありません。

ai_percentがnullになることがありますが、それは通常よい知らせです。 TurnitinはAIによる文章が20%未満の場合、数値の代わりに *を表示します。この範囲は誤検出が多すぎるため、数値化されません。そのため、nullは 「20%未満で、Turnitinはこれ以上何も示さない」という意味であり、「0%」でも「結果なし」でもありません。

よくある質問

これでTurnitinのAIスコアは下がりますか？ balancedで1回処理すれば、通常は20%未満になります。これは、Turnitinが数値の代わりに*を表示する基準値です。 基準を下回らない場合は、新しいレポートとともに結果を再度渡してください。フラグが付いたままの箇所だけを書き換えます。

iThenticateでも使えますか？ はい。どちらのレポートも渡せます。ファイルから形式を判別します。

文書はモデルに送信されますか？ いいえ。ファイルをアップロードし、パスを返します。40ページの論文でもトークンは消費しません。

プライバシーポリシー

ツールに渡した文書は、処理のためHumanPenのAPI （api.humanpen.net）にHTTPS経由でアップロードされます。結果はディスクに書き戻され、 処理済みファイルはcheck_jobと無料の再人間化処理で利用できるよう、サーバー側に約7日間保管されます。文書の内容がモデルの コンテキストに入ることはありません。収集情報、保持期間、お問い合わせ先を含むポリシー全文は https://humanpen.net/legal/privacyをご覧ください。

開発

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

selftest.mjsはビルド済みサーバーを起動し、実際のクライアントと同じ方法でstdio経由のJSON-RPC通信を行います。これにより、関数が値を返すことだけでなく、プロトコル、ツールの登録、標準出力の適切な処理、エンドツーエンドのジョブを1件検証します。実際に使えるキーが必要で、クレジットを消費するため、CIの手順ではなくリリース前の確認として実行します。

リンク

• APIドキュメント · OpenAPIスキーマ
• humanpen-skill — サーバーを実行したくない場合に使える、同じ 操作を行うAgent Skill
• humanpen.net

Apache-2.0