rubber-duck-mcp/apps/mcp

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.

Запуск

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

Проверка

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

vercel --prod

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