feat: add mcp server, reorganize repo

2026-09-03 17:20:08 +05:00
parent c1dda4d257
commit 1fd8ad6b50
48 changed files with 1691 additions and 12467 deletions
@@ -0,0 +1,45 @@
+# 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`.)