diff --git a/CLAUDE.md b/CLAUDE.md index e679650..3c80792 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co - `alfy-bot/` — NestJS-бэкенд (порт 3002): REST API под `/api`, Swagger на `/api/docs`, Telegram-бот (telegraf), TypeORM + SQLite (`data/database.sqlite`, `synchronize: true`), JWT + API-token auth (`JwtOrApiTokenGuard`), web-push. - `alfy-bot-frontend/` — Vue 3 + Vite + TS + Tailwind v4 + Pinia + vue-router. PWA (`vite-plugin-pwa`, кастомный `sw.ts`). Запускается как обычный SPA и как Telegram WebApp. -- `alfy-mcp/` — MCP-сервер (порт 3003, ESM, Node 22+): тонкая обёртка над REST `alfy-bot` для Claude Desktop/Code и удалённых MCP-клиентов. Транспорты: stdio + Streamable HTTP (endpoint `/mcp`). Auth — API-токены, выдаваемые ботом (`/mcp_token `). Не ходит в БД напрямую. +- `alfy-mcp/` — MCP-сервер (порт 3003, ESM, Node 22+): тонкая обёртка над REST `alfy-bot` для Claude Desktop/Code и удалённых MCP-клиентов. Транспорты: stdio + Streamable HTTP (endpoint `/mcp`). Auth — API-токены, выдаваемые в настройках веб-приложения или ботом (`/mcp_token `). Не ходит в БД напрямую. - `docker-compose.yml` + `Caddyfile` — прод: Caddy на 80/443 раздаёт `tracker.rocketup.tech`, проксирует `/api/*` на backend, `/mcp` + `/mcp/*` на alfy-mcp, остальное на frontend (nginx). - `scripts/tunnels.sh` — Cloudflare Quick Tunnels для dev (см. README). @@ -57,7 +57,7 @@ npm run test # vitest run npm run lint # eslint . ``` -ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `StreamableHTTPServerTransport`). Auth — API-токены через бот (`/mcp_token `), хранятся как bcrypt-хеш + 10-char prefix-index в БД (`api_token` entity). Tools — тонкая обёртка над REST `alfy-bot` (1 HTTP-вызов на tool, кроме `get_progress` — 3 параллельных). См. `alfy-mcp/README.md` для подключения из клиентов. +ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `StreamableHTTPServerTransport`). Auth — API-токены из настроек профиля или Telegram-команды `/mcp_token `, хранятся как bcrypt-хеш + 10-char prefix-index в БД (`api_token` entity). В настройках токен показывается только при выдаче, затем доступен только его префикс; отзыв прекращает доступ. Управление токенами через `/api/auth/api-tokens` доступно только с JWT, не с API-токеном. Для HTTP-клиентов адрес в production — `https://tracker.rocketup.tech/mcp`, локально — `http://localhost:3003/mcp`; `VITE_MCP_URL` задаёт адрес в инструкции фронта, без неё используется `/mcp` текущего origin. Tools — тонкая обёртка над REST `alfy-bot` (1 HTTP-вызов на tool, кроме `get_progress` — 3 параллельных). См. `alfy-mcp/README.md` для подключения из клиентов. **MCP-планирование спринтов.** `tools/sprints.ts` регистрируется в общем `createServer` для обоих транспортов. Контроллеры спринтов и групп используют `JwtOrApiTokenGuard`, иначе MCP API-токен получает 401. `move_story_to_sprint` вызывает атомарный серверный перенос; не заменять его циклом обновления задач. `complete_sprint` требует явный `moveTo`, `delete_sprint` — `confirm: true`. У задач доступны `groupId`/`sprintId` и фильтр `sprint_id`; создание без `sprintId` наследует спринт истории. Контракты проверяются через реальный MCP SDK в `alfy-mcp/tests/tools/sprints.spec.ts` и HTTP-тест API-токена в `alfy-bot/test/story-sprint.e2e-spec.ts`. diff --git a/README.md b/README.md index 0908884..b4a9798 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ ## Чем интересен проект -- **🤖 AI-native через MCP.** Отдельный [MCP-сервер](alfy-mcp/) даёт Claude Desktop / Claude Code полный набор инструментов для управления задачами, целями и привычками. Можно сказать ассистенту «создай цель на квартал и распиши привычки» — и он сделает это через типизированные tools, а не парсинг текста. Транспорты stdio и Streamable HTTP, авторизация по API-токенам из бота. +- **🤖 AI-native через MCP.** Отдельный [MCP-сервер](alfy-mcp/) даёт Claude Desktop / Claude Code полный набор инструментов для управления задачами, целями и привычками. Можно сказать ассистенту «создай цель на квартал и распиши привычки» — и он сделает это через типизированные tools, а не парсинг текста. Транспорты stdio и Streamable HTTP, авторизация по API-токенам из настроек профиля или бота. - **🎯 Цели → привычки → честный self-report.** Цель раскладывается на вопросы-привычки с расписанием (ежедневно / по дням недели / с интервалом). Семь типов вопросов: текст, оценка числом, оценка смайликами, да/нет, число, затраченное время, фото. Данные опроса — основа для аналитики и коучинга, а не «галочка выполнено». - **📱 Три поверхности, один бэкенд.** Telegram-бот (telegraf), Telegram WebApp и обычный SPA — всё работает поверх одного REST API. Веб собран как PWA (offline, web-push, установка на домашний экран). - **🧱 Чистая архитектура.** Бэкенд — Clean Architecture по модулям (порты в `domain/`, адаптеры в `infrastructure/`, оркестрация в сервисах). Фронтенд — Feature-Sliced Design. Границы слоёв реальны, а не декоративны. diff --git a/alfy-bot-frontend/.env.example b/alfy-bot-frontend/.env.example index 410f14d..ee9aa35 100644 --- a/alfy-bot-frontend/.env.example +++ b/alfy-bot-frontend/.env.example @@ -1,4 +1,5 @@ VITE_API_URL=http://localhost:3002/api +VITE_MCP_URL=http://localhost:3003/mcp # Dev auth (no WebApp): VITE_DEV_USE_WIDGET=true|false # true: Login Widget on /login (backend: BOT_TOKEN for widget validation) diff --git a/alfy-bot-frontend/src/features/mcp/api/tokens.ts b/alfy-bot-frontend/src/features/mcp/api/tokens.ts new file mode 100644 index 0000000..6ad4994 --- /dev/null +++ b/alfy-bot-frontend/src/features/mcp/api/tokens.ts @@ -0,0 +1,18 @@ +import type { CreatedMcpToken, McpToken } from '../model/types' +import { api } from '@/api/client' + +const path = '/auth/api-tokens' + +export async function listTokens(): Promise { + const { data } = await api.get(path) + return data +} + +export async function createToken(name: string): Promise { + const { data } = await api.post(path, { name }) + return data +} + +export async function revokeToken(id: number): Promise { + await api.delete(`${path}/${id}`) +} diff --git a/alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts b/alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts new file mode 100644 index 0000000..85b03de --- /dev/null +++ b/alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts @@ -0,0 +1,22 @@ +export interface ConnectionGuide { + codex: string + claudeCode: string + generic: string +} + +export function resolveMcpUrl(override: string | undefined, origin: string): string { + const url = override?.trim() ? new URL(override.trim()) : new URL('/mcp', origin) + if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.hash) { + throw new Error('Адрес MCP должен использовать HTTP или HTTPS без логина и фрагмента') + } + return url.toString() +} + +export function buildConnectionGuide(url: string): ConnectionGuide { + const encodedUrl = JSON.stringify(url) + return { + codex: `[mcp_servers.alfy]\nurl = ${encodedUrl}\nbearer_token_env_var = "ALFY_MCP_TOKEN"`, + claudeCode: JSON.stringify({ mcpServers: { alfy: { type: 'http', url, headers: { Authorization: `Bearer \${ALFY_MCP_TOKEN}` } } } }, null, 2), + generic: JSON.stringify({ type: 'http', url, headers: { Authorization: 'Bearer YOUR_ALFY_TOKEN' } }, null, 2), + } +} diff --git a/alfy-bot-frontend/src/features/mcp/model/types.ts b/alfy-bot-frontend/src/features/mcp/model/types.ts new file mode 100644 index 0000000..7a1c9f9 --- /dev/null +++ b/alfy-bot-frontend/src/features/mcp/model/types.ts @@ -0,0 +1,12 @@ +export interface McpToken { + id: number + name: string + prefix: string + created_at: string + last_used_at: string | null +} + +export interface CreatedMcpToken { + id: number + plaintext: string +} diff --git a/alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts b/alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts new file mode 100644 index 0000000..552544f --- /dev/null +++ b/alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts @@ -0,0 +1,78 @@ +import type { CreatedMcpToken, McpToken } from './types' +import { ref } from 'vue' +import { createToken, listTokens, revokeToken } from '../api/tokens' + +export function useMcpTokens() { + const tokens = ref([]) + const revealed = ref(null) + const loading = ref(false) + const creating = ref(false) + const revokingId = ref(null) + const loadError = ref(null) + const createError = ref(null) + const revokeError = ref(null) + + async function fetchTokens(): Promise { + if (loading.value) + return + loading.value = true + loadError.value = null + try { + tokens.value = await listTokens() + } + catch { + loadError.value = 'Не удалось загрузить список токенов' + } + finally { + loading.value = false + } + } + + async function refresh(): Promise { + if (creating.value || revokingId.value !== null) + return + await fetchTokens() + } + + async function create(name: string): Promise { + if (creating.value || loading.value || revokingId.value !== null || !name.trim()) + return + creating.value = true + createError.value = null + try { + revealed.value = await createToken(name.trim()) + await fetchTokens() + } + catch { + createError.value = 'Не удалось создать токен. Обновите список и отзовите лишний токен, если запрос всё же прошёл.' + } + finally { + creating.value = false + } + } + + async function revoke(id: number): Promise { + if (revokingId.value !== null || loading.value || creating.value) + return + revokingId.value = id + revokeError.value = null + try { + await revokeToken(id) + tokens.value = tokens.value.filter(token => token.id !== id) + if (revealed.value?.id === id) + revealed.value = null + } + catch { + revokeError.value = 'Не удалось отозвать токен' + } + finally { + revokingId.value = null + } + } + + function dismissSecret(): void { + revealed.value = null + } + + return { tokens, revealed, loading, creating, revokingId, loadError, createError, revokeError, refresh, create, revoke, dismissSecret } +} diff --git a/alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue b/alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue new file mode 100644 index 0000000..64fa30a --- /dev/null +++ b/alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue @@ -0,0 +1,77 @@ + + + diff --git a/alfy-bot-frontend/src/features/mcp/ui/McpSettings.vue b/alfy-bot-frontend/src/features/mcp/ui/McpSettings.vue new file mode 100644 index 0000000..8f9ddaf --- /dev/null +++ b/alfy-bot-frontend/src/features/mcp/ui/McpSettings.vue @@ -0,0 +1,153 @@ + + +