# cursor-yougpu-mcp

MCP-сервер для [YouGPU REST API](https://docs.yougpu.ru/api/overview/): каталог GPU, создание/стоп/старт/удаление инстансов, баланс.

Архитектура пайплайна транскрибации и диаризации: [docs/TRANSCRIPTION_ARCHITECTURE.md](docs/TRANSCRIPTION_ARCHITECTURE.md).

## Tools

| Tool | Описание |
|------|----------|
| `yougpu_balance` | Баланс кошелька |
| `yougpu_list_gpus` | Каталог моделей GPU |
| `yougpu_list_offers` | Офферы/цены по `gpu_id` |
| `yougpu_list_ssh_keys` | SSH-ключи аккаунта |
| `yougpu_list_instances` | Список инстансов |
| `yougpu_get_instance` | Детали инстанса |
| `yougpu_create_instance` | Создать инстанс |
| `yougpu_wait_ready` | Ждать ACTIVE + IP |
| `yougpu_stop_instance` | Остановить |
| `yougpu_start_instance` | Запустить |
| `yougpu_delete_instance` | Terminate (стоп биллинга GPU) |

## Setup

```bash
mkdir -p ~/.config/yougpu
cp config.example.env ~/.config/yougpu/config.env
# set YOUGPU_API_KEY=...

npm install
npm run build
chmod +x bin/cursor-yougpu-mcp
ln -sf "$PWD/bin/cursor-yougpu-mcp" ~/.local/bin/cursor-yougpu-mcp
```

В `~/.cursor/mcp.json`:

```json
"yougpu": {
  "command": "/Users/YOUR_USER/.local/bin/cursor-yougpu-mcp",
  "args": []
}
```

API key создаётся в [console.yougpu.ru](https://console.yougpu.ru) (раздел API Keys). Документация: https://docs.yougpu.ru/api/overview/