Skip to main content
Glama
README.md
# Budka MCP

MCP сервер для генерации изображений через [CyberPhotoBooth API](https://cyberphotobooth.ru) 

## Инструменты

- **get_aspect_ratios** — список доступных соотношений сторон
- **create_prompt** — помощь в написании промпта для генерации
- **generate_image** — генерация изображения по промпту

## Установка

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

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

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

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

```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 команду:

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

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

Управление:

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

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 issues