SeeAny Sun MCP

Этот каталог предоставляет локальный stdio MCP-сервер, который могут вызывать MCP-клиенты, такие как Codex, Claude Desktop, Cursor и другие.

Он поддерживает два режима:

• demo: не требует ключа, выполняет офлайн-симуляцию на товарных изображениях из репозитория и не вызывает платных API.

• live: после установки SEEANY_API_KEY вызывает основной сайт https://api.seeany.com; поддерживает загрузку изображений, интеллектуальное создание, опрос статуса задач, скачивание и AI-доработку.

Переменная окружения для аутентификации

Используется единая переменная:

SEEANY_API_KEY=sk-sa-xxxxxxxx

Не записывайте реальный ключ в Git, код браузера или сообщения чата. Просто скопируйте .env.example в локальное окружение и заполните. Без ключа сервис автоматически переходит в режим Demo; также можно принудительно включить офлайн-режим с помощью SEEANY_MCP_MODE=demo.

Related MCP server: metalevel/snapix-mcp-server

Локальная установка и тестирование

cd mcp-server
npm install
npm run build
npm run smoke

Smoke-тест принудительно использует режим Demo и не создаёт реальных расходов.

Чтобы выполнить приёмку реального конвейера (это приведёт к расходам на основном аккаунте), после установки нового ключа выполните:

npm run live-smoke

Подключение Codex

codex mcp add seeany-sun-mcp -- npx --yes seeany-sun-mcp

Установка в качестве плагина Codex (MCP + Skill)

Репозиторий также содержит манифест плагина Codex: после установки вы получите одновременно инструменты SeeAny MCP и скилл рабочего процесса товарных изображений seeany-product-visuals.

codex plugin marketplace add juin20260102-oss/seeany-sun-mcp --sparse .agents/plugins
codex plugin add seeany-sun-mcp@seeany

После установки откройте новый диалог Codex; для реальной генерации изображений по-прежнему нужно задать SEEANY_API_KEY в локальном окружении. Если нужны только MCP-инструменты, используйте приведённую выше команду codex mcp add.

Если вы используете реальный API, задайте SEEANY_API_KEY в том же окружении, где запущен MCP. После подключения рекомендуется сначала вызвать seeany_get_capabilities, а затем вызывать инструменты в следующем порядке:

1. seeany_upload_asset (при наличии референсного изображения)

2. seeany_refine_prompt (необязательно)

3. seeany_generate_product_image

4. seeany_wait_generation

5. seeany_download_assets

MCP Inspector

npm run inspect

Текущее сопоставление реальных API

Задачи по умолчанию выполняются в асинхронном режиме. Задачи с изображениями/видео через основной API тарифицируются в соответствии с конфигурацией аккаунта; seeany_quote_generation возвращает только оценочное значение и не списывает средства заранее.

SeeAny Skill

В репозитории содержится skills/seeany-product-visuals, который помогает агенту вызывать MCP по полному процессу: «загрузка референса → доработка промпта → запрос цены → генерация → опрос статуса → скачивание». npm-пакет также будет включать этот каталог Skill.

Имя npm-пакета

Текущее имя пакета — seeany-sun-mcp; оно подходит для выпуска публичного пакета без scope. Перед официальной публикацией нужно проверить доступность имени в npm; если SeeAny уже создал npm-scope, можно мигрировать на @seeany/sun-mcp.

Простейший способ вызова после публикации:

npx --yes seeany-sun-mcp

Проверка содержимого пакета перед публикацией:

npm run pack:check

Автоматическое тестирование и публикация

GitHub Actions при Push в ветку main и при Pull Request будет выполнять с помощью Node.js 20, 22, 24 проверку плагинов, MCP Smoke-тест и проверку npm-упаковки.

При выпуске новой версии сначала синхронно обновите версии в package.json, package-lock.json и .codex-plugin/plugin.json, затем создайте Git-тег той же версии:

git tag v0.5.0
git push origin v0.5.0

release.yml проверит, что Tag совпадает с версией пакета, затем опубликует через npm Trusted Publishing и создаст GitHub Release. Перед первым использованием необходимо добавить в настройки npm-пакета GitHub Actions Trusted Publisher:

• Пользователь GitHub: juin20260102-oss

• Репозиторий: seeany-sun-mcp

• Workflow: release.yml

• Allowed action: npm publish