humantone-mcp

HumanToneの公式Model Context Protocolサーバーです。Claude Desktop、Cursor、ClineなどのMCPクライアントから、HumanToneのヒューマナイズツールやAI生成確率検出ツールを直接利用できます。HumanToneのウェブアプリですでに使用しているAPIキーとクレジットをそのまま利用可能です。

HumanToneは、AIが生成したコンテンツをより自然な響きに書き換えるAIテキストヒューマナイザーです。このMCPサーバーを使用することで、AIアシスタント内でこれらのツールを活用できるようになります。

早期リリース版（v0.0.x）です。アップデート情報はGitHubで確認してください。

要件

• Node.js 18以降。

• APIアクセス権を持つHumanToneの有料プラン。無料トライアルアカウントではAPIを使用できません。

• app.humantone.io/settings/apiで取得したAPIキー。

Related MCP server: PostIdentity MCP Server

インストール

インストール手順はありません。MCPクライアントが初回起動時に npx humantone-mcp を通じてパッケージをダウンロードします。以下の設定スニペットをクライアントに追加するだけです。

設定

Claude Desktop

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

ファイルを編集した後、Claude Desktopを再起動してください。

Cursor

設定（Settings）からMCPを選択するか、~/.cursor/mcp.json を直接編集して設定します。

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

設定を編集した後、Cursorを再起動してください。

Cline (VSCode拡張機能)

Clineの設定（Settings）からMCP Serversを選択し、以下の構造でスニペットを追加します：

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

設定を編集した後、VSCodeを再起動してください。

その他のMCPクライアント

humantone-mcpは、GitHub Copilotエージェントモードを搭載したVSCode、Codex CLI、Gemini CLI、Continue.dev、Zed、Windsurf、JetBrains AI Assistantなど、MCP互換のあらゆるクライアントで動作します。設定パターンはどのクライアントでも共通で、環境変数に HUMANTONE_API_KEY を含めたコマンド（npx -y humantone-mcp）を使用します。

クライアントごとの設定スニペットやトラブルシューティングについては、humantone.io/docs/mcp/を参照してください。

ツール

• humanize: テキストをより自然で人間が書いたような文章に書き換えます。トーン、ターゲット読者、専門用語の保持に関するカスタム指示をサポートしています。

• detect_ai: テキストのAI生成確率（0〜100）をチェックします。クレジットは消費されません。1日30回までチェック可能で、HumanToneウェブアプリと共有されます。

• get_account: 現在のプラン、クレジット、サブスクリプション状況を表示します。

使用例

設定が完了したら、アシスタントに自然に話しかけてください。メッセージ内で humantone や特定のツール名に言及すると、モデルが確実にMCPツールへルーティングしやすくなります。特に、モデルが自分でテキストを書き換えてしまう可能性があるヒューマナイズのリクエストでは有効です。

ヒューマナイズ:

• "Use humantone to rewrite this draft so it reads more naturally: <テキストを貼り付け>"

• "Run this through humantone with a formal corporate tone: <テキストを貼り付け>"

• "Pass this to humantone, set level to advanced, and preserve the term Kubernetes intact: <テキストを貼り付け>"

AI生成確率のチェック:

• "Use humantone's AI detector to score this paragraph: <テキストを貼り付け>"

• "Check AI likelihood with humantone: <テキストを貼り付け>"

• "Run this through humantone detect_ai: <テキストを貼り付け>"

アカウント状況:

• "How many HumanTone credits do I have left?"

• "What is my current HumanTone plan?"

• "When does my HumanTone subscription renew?"

トラブルシューティング

• ツールがアシスタントに表示されない。 JSON設定に構文エラーがないか確認し、クライアントを完全に終了してから再起動してください。ウィンドウの更新だけでは不十分です。

• "Invalid API key format" エラー。 キーは67文字です：ht_ に続いて64文字の16進数が続きます。不明な場合は app.humantone.io/settings/api で新しいキーを生成してください。

• "Plan does not include API access" エラー。 無料トライアルアカウントではAPIを使用できません。有料プランは humantone.io/pricing で確認してください。

• "npx: command not found"。 nodejs.org からNode.js 18以降をインストールしてください。

リンク

• その他のクライアント向けMCPセットアップガイド: https://humantone.io/docs/mcp/

• APIドキュメント: https://humantone.io/docs/api/

• HumanTone Node SDK (本サーバーで使用): https://www.npmjs.com/package/humantone

• APIキーの取得: https://app.humantone.io/settings/api

• 問題報告: https://github.com/humantone/humantone-mcp/issues

• 開発者メールアドレス: dev@humantone.io

• 製品サポート: help@humantone.io

ライセンス

MIT. Copyright (c) HumanTone.