clarity-api-mcp

Bun MCP-сервер для Clarity AI апскейлера. Одна POST-конечная точка, все официальные режимы.

Возможности

• Инструменты: clarity_list_models, clarity_upscale

• Режимы: crystal, crystal-video, clarity (алиас creative), clarity-pro

• Локальные файлы: публикуются по публичному raw-URL (uguu, litterbox или Tailscale Funnel) перед POST-запросом к Clarity

• Страницы общего доступа Dropbox и HTML-страницы tmpfiles.org переписываются в прямые URL файлов

• Нативно для Bun: TypeScript без шага компиляции, автоматический .env, Bun.file / Bun.write, Bun Shell curl

• Структурированный вывод MCP плюс текстовый запасной вариант

Требования

• Bun >= 1.1

• Ключ API Clarity AI с https://clarityai.co/api

Настройка

git clone https://github.com/thomastraum/clarity-api-mcp.git
cd clarity-api-mcp
bun install
cp .env.example .env

Поместите ваш ключ в .env (никогда не коммитьте этот файл):

CLARITY_API_KEY=your-key-here

Bun загружает .env автоматически. Сервер также читает .env этого пакета, когда агент кодирования запускает его из другого каталога.

Конфигурация MCP-клиента

Замените путь на ваш клон:

{
  "mcpServers": {
    "clarity-api": {
      "command": "bun",
      "args": ["/absolute/path/to/clarity-api-mcp/src/index.ts"]
    }
  }
}

Ключ может находиться в .env или в блоке env MCP. См. docs/INSTALL.md для фрагментов для Claude, Cursor, Codex и Grok.

Инструменты

clarity_list_models

Возвращает каждый режим, список параметров и пример тела запроса с официальной страницы API.

clarity_upscale

Отправляет POST https://api-upscale.clarityai.co с Authorization: Bearer ….

Входные данные (общие)

Crystal — scale_factor 1–200, creativity 0–10, output_format jpg/png, target_megapixels 0.001–1500

Crystal Video — scale_factor 1–200

Clarity — creativity / resemblance / dynamic / fractality −10–10, scale_factor 2–16, style default/portrait/anime, postprocessing none/sharpen, prompt

Clarity Pro — creativity −10–10, scale_factor 2/4/8/16, output_format png/jpg. $0.03 за выходной MP, максимум 64 MP.

Выходные данные

{
  "mode": "crystal",
  "requested_mode": "crystal",
  "url": "https://…",
  "credit_cost": 3,
  "cost_usd": 0.03,
  "balance": 97,
  "webhook": null,
  "saved_to": "/path/to/out.jpg",
  "published_url": "https://a.uguu.se/…",
  "published_via": "uguu",
  "note": null
}

Clarity взимает 1 кредит = $0.01. Локальные файлы публикуются сначала, чтобы Clarity могла получить raw-байты. Используйте publish: "funnel", если файл должен остаться на этой машине (Tailscale Funnel, не Serve).

Переменные окружения

Скрипты

bun start
bun test
bun run smoke-test
bun run smoke-test -- --live

--live вызывает реальный API и тратит кредиты.

Примечания

• Не пишите в stdout из этого процесса, кроме транспорта MCP. Диагностика идет в stderr.

• HTTP-клиент — это Bun Shell curl, соответствующий официальным примерам, с телом Response в stdin.

Лицензия

MIT