# Rubber Duck MCP

MCP-сервер для техники «резиновая уточка»: когда ИИ застревает в логическом цикле или склонен к
галлюцинациям, он вызывает инструмент `quack()`, чтобы сформулировать мысль и продолжить.

Сервер работает в режиме **Streamable HTTP** (stateless), развёртывается на Vercel, использует
`mcp-handler` v2 + `@modelcontextprotocol/server` v2.

## Эндпоинт

```
POST /api/mcp
```

Подключите этот URL как MCP-сервер (тип Streamable HTTP) в Cursor, Claude Desktop и других клиентах.

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

- `quack` — возвращает кряк. Опциональный параметр `mood`: `happy | confused | excited | sleepy`.

## Запуск

```bash
pnpm install
pnpm dev       # http://localhost:3000
pnpm build
pnpm start
```

## Проверка

```bash
curl -X POST http://localhost:3000/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"quack","arguments":{"mood":"happy"}}}'
```

## Деплой на Vercel

```bash
vercel --prod
```

(`rootDirectory` проекта — `apps/mcp`.)