Skip to main content
Glama

Budka MCP

MCP сервер для генерации изображений через CyberPhotoBooth API

Инструменты

  • get_aspect_ratios — список доступных соотношений сторон

  • create_prompt — помощь в написании промпта для генерации

  • generate_image — генерация изображения по промпту

Related MCP server: image-forge-mcp

Установка

git clone https://github.com/curlysasha/CyberPhotoBooth_MCP.git
cd Budka_MCP
npm install
npm run build

Подключение к Claude Code

Для одного проекта

Создай .mcp.json в корне нужного проекта:

{
  "mcpServers": {
    "budka": {
      "command": "node",
      "args": ["C:\\путь\\до\\Budka_MCP\\dist\\index.js"],
      "env": {
        "BUDKA_API_KEY": "твой-api-ключ"
      }
    }
  }
}

В WSL путь будет /mnt/c/..., на Windows — C:\...

Перезапусти Claude Code — сервер подключится автоматически.

Глобально (для всех проектов)

Через CLI команду:

claude mcp add budka --scope user -e BUDKA_API_KEY=твой-api-ключ -- node /путь/до/Budka_MCP/dist/index.js

Конфиг сохранится в ~/.claude.json и сервер будет доступен в любом проекте.

Управление:

claude mcp list          # список серверов
claude mcp remove budka  # удалить

Available Tools

5 tools
check_jobCheck Job StatusA

Check the status of a previously submitted image generation job. Use this if generate_image timed out or was interrupted, to retrieve the result without creating a new job.

Inputs: job_id (required).

create_promptCreate Image PromptA

Generates an optimized English prompt for Flux Klein image generation model based on your description. Describe what you want (theme, style, mood) and get back a well-structured prompt following best practices. The prompt will be universal (no gender/count specifics).

Inputs: description (required), length.

generate_imageGenerate ImageA

Generates an image using the Budka (CyberPhotoBooth) API. Async: submits a job then polls for result. Statuses: queued → processing → completed/failed. If timed out or interrupted, use check_job with the job_id to retrieve the result without creating a new job. Requires BUDKA_API_KEY.

Inputs: prompt (required), mode, ratio.

get_aspect_ratiosGet Aspect RatiosA

Returns the list of available aspect ratios for image generation. Pass a mode to get ratios for a specific model, or omit to see all ratios grouped by model.

Inputs: mode.

get_modelsGet ModelsA

Returns the list of available image generation models. Use this when user asks which models are available.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    TDQS

    A4.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: models, aspect ratios, prompt generation, job creation, and job status checking. Even get_models and get_aspect_ratios are clearly separated by resource type, and generate_image vs check_job are unambiguously create vs retrieve.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case: get_models, get_aspect_ratios, create_prompt, check_job, generate_image. The verbs and nouns clearly indicate the action and target, making the API predictable.

    Tool Count5/5

    Five tools is well-scoped for an image generation server, covering configuration, prompt creation, generation, and status retrieval without unnecessary bloat or missing essentials.

    Completeness4/5

    The core image generation lifecycle is covered: list models, list ratios, create prompt, submit job, check job. Minor gaps like a cancel or list-jobs tool are absent, but agents can work around them since check_job relies on a job_id from generate_image.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers