wikivibe-images-mcp

MCP-сервер для генерации и редактирования изображений через WikiVibe. Работает в любом агенте с поддержкой MCP: OMP, Codex CLI, Claude Code, Cursor, opencode/Orca.

Поставил → сказал «сделай картинку через wikivibe» → получил файл.

┌──────────────┐
│ OMP          │─┐
│ Codex CLI    │─┤   stdio    ┌────────────────┐   HTTPS   ┌──────────────────┐
│ Claude Code  │─┼───────────▶│wikivibe-images │──────────▶│ api.wikivibe.ru  │
│ Cursor       │─┤            │  (один бандл)  │           │ /images/…        │
│ opencode     │─┘            └────────┬───────┘           └──────────────────┘
└──────────────┘                       │
                              ~/.wikivibe/credentials.json (0600)

Быстрый старт

npx -y wikivibe-images-mcp login        # сохранить ключ (один раз)
npx -y wikivibe-images-mcp setup all    # прописать сервер во все агенты

Перезапустить агент и попросить:

сделай картинку через wikivibe: рыжий кот в космическом шлеме, фотореализм

Агент вызовет generate_image, получит путь к файлу и покажет картинку.

setup без аргументов или с all обходит все клиенты; можно указать выборочно:

npx -y wikivibe-images-mcp setup omp codex

Доступные имена: omp, claude, codex, cursor, opencode (она же orca).

setup копирует собранный сервер в ~/.wikivibe/bin/wikivibe-images-mcp.js и прописывает именно этот путь. Конфиги агентов не зависят ни от каталога репозитория, ни от кэша npx: после обновления достаточно заново выполнить setup.

Related MCP server: imaginate-mcp

Ручная настройка

Если не хотите запускать setup, добавьте сервер сами. Везде ниже используется стабильная копия; вместо неё можно указать npx -y wikivibe-images-mcp mcp.

OMP — ~/.omp/agent/mcp.json:

{
  "mcpServers": {
    "wikivibe": {
      "command": "node",
      "args": ["/Users/YOU/.wikivibe/bin/wikivibe-images-mcp.js", "mcp"],
      "timeout": 300000
    }
  }
}

Codex CLI — ~/.codex/config.toml:

[mcp_servers.wikivibe]
command = "node"
args = ["/Users/YOU/.wikivibe/bin/wikivibe-images-mcp.js", "mcp"]
tool_timeout_sec = 300

Claude Code:

claude mcp add --scope user wikivibe -- node ~/.wikivibe/bin/wikivibe-images-mcp.js mcp

Cursor — ~/.cursor/mcp.json: тот же JSON, что и для OMP.

opencode / Orca — ~/.config/opencode/opencode.json:

{
  "mcp": {
    "wikivibe": {
      "type": "local",
      "command": ["node", "/Users/YOU/.wikivibe/bin/wikivibe-images-mcp.js", "mcp"],
      "enabled": true
    }
  }
}

Таймауты. Генерация одной картинки занимает 25–45 секунд, а клиенты по умолчанию обрывают MCP-вызов раньше. Поэтому в OMP нужен "timeout": 300000, в Codex — tool_timeout_sec = 300, в Claude Code — MCP_TOOL_TIMEOUT=300000 в окружении.

Инструменты

Каждый результат — путь к файлу на диске и сам файл как MCP image-блок, поэтому картинку видно и в агентах без доступа к файловой системе.

Несколько картинок за один вызов

// варианты одного промпта
{ "prompt": "керамическая чашка, продуктовое фото", "n": 3 }

// разные картинки
{ "prompts": ["лиса акварелью", "кит акварелью", "сова акварелью"] }

Максимум 4 изображения за вызов. Запросы идут строго последовательно: API WikiVibe не принимает n > 1 для gpt-image-* (апстрим отвечает unknown_parameter: tools[0].n), а параллельные вызовы роняют его в 502. Время растёт линейно — примерно 25–45 секунд на картинку.

Ключ API

Ключ хранится только в ~/.wikivibe/credentials.json (права 0600, каталог 0700). В конфиги агентов он не попадает — там лишь команда запуска.

wikivibe-images login                  # интерактивно, ввод скрыт
wikivibe-images login --key sk-…       # для CI
wikivibe-images import                 # подхватить WIKIVIBE_API_KEY из ~/.omp/.env или ./.env
wikivibe-images status                 # проверить ключ, base URL и доступные модели

Приоритет источников: WIKIVIBE_API_KEY → ~/.wikivibe/credentials.json.

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

CLI без агента

wikivibe-images image "постер: закат над морем, минимализм"
wikivibe-images models

wikivibe-images — это тот же файл, что лежит в ~/.wikivibe/bin/. Можно добавить в PATH:

ln -s ~/.wikivibe/bin/wikivibe-images-mcp.js /usr/local/bin/wikivibe-images

Ошибки

Разработка

Нужен Node.js 20+.

npm install
npm run typecheck
npm run build      # esbuild → dist/cli.js, самодостаточный бандл
node dist/cli.js status
node dist/cli.js setup omp

Проверка MCP-протокола вручную:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/cli.js mcp

Структура:

Ссылки

• npm: https://www.npmjs.com/package/wikivibe-images-mcp

• исходники: https://github.com/AlexMi64/wikivibe-images-mcp

Лицензия

MIT