humantone-mcp

Официальный сервер протокола Model Context Protocol для HumanTone. Используйте инструменты HumanTone для гуманизации и проверки вероятности ИИ прямо из Claude Desktop, Cursor, Cline и других MCP-клиентов. Один API-ключ, те же кредиты, которые вы уже используете в веб-приложении HumanTone.

HumanTone — это инструмент для гуманизации ИИ-текста, который переписывает контент, созданный ИИ, чтобы он звучал более естественно. Этот MCP-сервер добавляет эти инструменты в вашего ИИ-ассистента.

Ранний выпуск (v0.0.x). Следите за обновлениями на GitHub.

Требования

• Node.js 18 или новее.

• Платный тарифный план HumanTone с доступом к API. Бесплатные пробные аккаунты не могут использовать API.

• API-ключ с сайта app.humantone.io/settings/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» (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 работает с любым MCP-совместимым клиентом, включая VSCode в режиме агента GitHub Copilot, Codex CLI, Gemini CLI, Continue.dev, Zed, Windsurf, JetBrains AI Assistant и другими. Шаблон конфигурации одинаков для всех клиентов: команда (npx -y humantone-mcp) с переменной HUMANTONE_API_KEY в окружении.

См. humantone.io/docs/mcp/ для получения фрагментов настройки для конкретных клиентов и устранения неполадок.

Инструменты

• humanize переписывает текст, чтобы он звучал более естественно и «по-человечески». Поддерживает пользовательские инструкции по тону, аудитории и терминологии.

• detect_ai проверяет вероятность того, что текст написан ИИ (от 0 до 100). Не расходует кредиты. 30 проверок в день, общих с веб-приложением HumanTone.

• get_account показывает текущий тарифный план, кредиты и статус подписки.

Примеры использования

После настройки общайтесь со своим ассистентом естественным образом. Упоминание humantone или конкретных названий инструментов в вашем сообщении помогает модели надежно перенаправлять запрос к MCP-инструменту, особенно для запросов на гуманизацию, где модель в противном случае могла бы переписать текст самостоятельно.

Гуманизация:

• "Используй humantone, чтобы переписать этот черновик, чтобы он читался более естественно: <вставьте ваш текст>"

• "Пропусти это через humantone с формальным корпоративным тоном: <вставьте ваш текст>"

• "Передай это в humantone, установи уровень на advanced и сохрани термин Kubernetes без изменений: <вставьте ваш текст>"

Проверка вероятности ИИ:

• "Используй детектор ИИ от humantone, чтобы оценить этот абзац: <вставьте ваш текст>"

• "Проверь вероятность ИИ с помощью humantone: <вставьте ваш текст>"

• "Пропусти это через humantone detect_ai: <вставьте ваш текст>"

Статус аккаунта:

• "Сколько кредитов HumanTone у меня осталось?"

• "Какой у меня текущий тарифный план HumanTone?"

• "Когда продлевается моя подписка HumanTone?"

Устранение неполадок

• Инструменты не появляются в ассистенте. Убедитесь, что в JSON-конфигурации нет синтаксических ошибок, затем полностью закройте и снова откройте клиент. Обновления окна недостаточно.

• Ошибка "Invalid API key format". Ключи состоят из 67 символов: ht_ и 64 шестнадцатеричных символа. Если не уверены, создайте новый ключ на app.humantone.io/settings/api.

• Ошибка "Plan does not include API access". Бесплатные пробные аккаунты не могут использовать API. Посмотрите платные тарифы на humantone.io/pricing.

• "npx: command not found". Установите Node.js 18 или новее с nodejs.org.

Ссылки

• Руководство по настройке 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

• Email автора: dev@humantone.io

• Поддержка продукта: help@humantone.io

Лицензия

MIT. Copyright (c) HumanTone.