Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <name>`). Не ходит в БД напрямую.
- `alfy-mcp/` — MCP-сервер (порт 3003, ESM, Node 22+): тонкая обёртка над REST `alfy-bot` для Claude Desktop/Code и удалённых MCP-клиентов. Транспорты: stdio + Streamable HTTP (endpoint `/mcp`). Auth — API-токены, выдаваемые в настройках веб-приложения или ботом (`/mcp_token <name>`). Не ходит в БД напрямую.
- `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).

Expand Down Expand Up @@ -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 <name>`), хранятся как 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 <name>`, хранятся как 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`.

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. Границы слоёв реальны, а не декоративны.
Expand Down
1 change: 1 addition & 0 deletions alfy-bot-frontend/.env.example
Original file line number Diff line number Diff line change
@@ -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)
Expand Down
18 changes: 18 additions & 0 deletions alfy-bot-frontend/src/features/mcp/api/tokens.ts
Original file line number Diff line number Diff line change
@@ -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<McpToken[]> {
const { data } = await api.get<McpToken[]>(path)
return data
}

export async function createToken(name: string): Promise<CreatedMcpToken> {
const { data } = await api.post<CreatedMcpToken>(path, { name })
return data
}

export async function revokeToken(id: number): Promise<void> {
await api.delete(`${path}/${id}`)
}
22 changes: 22 additions & 0 deletions alfy-bot-frontend/src/features/mcp/lib/connection-guide.ts
Original file line number Diff line number Diff line change
@@ -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),
}
}
12 changes: 12 additions & 0 deletions alfy-bot-frontend/src/features/mcp/model/types.ts
Original file line number Diff line number Diff line change
@@ -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
}
78 changes: 78 additions & 0 deletions alfy-bot-frontend/src/features/mcp/model/useMcpTokens.ts
Original file line number Diff line number Diff line change
@@ -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<McpToken[]>([])
const revealed = ref<CreatedMcpToken | null>(null)
const loading = ref(false)
const creating = ref(false)
const revokingId = ref<number | null>(null)
const loadError = ref<string | null>(null)
const createError = ref<string | null>(null)
const revokeError = ref<string | null>(null)

async function fetchTokens(): Promise<void> {
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<void> {
if (creating.value || revokingId.value !== null)
return
await fetchTokens()
}

async function create(name: string): Promise<void> {
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<void> {
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 }
}
77 changes: 77 additions & 0 deletions alfy-bot-frontend/src/features/mcp/ui/McpConnectionGuide.vue
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
<script setup lang="ts">
import { computed, ref } from 'vue'
import { Button } from '@/components/ui/button'
import { buildConnectionGuide, resolveMcpUrl } from '../lib/connection-guide'

const copyError = ref<string | null>(null)
const copied = ref(false)
const configError = ref<string | null>(null)
let url = ''
try {
url = resolveMcpUrl(import.meta.env.VITE_MCP_URL, window.location.origin)
}
catch {
configError.value = 'Адрес MCP недоступен. Обратитесь к администратору.'
}

const examples = computed(() => {
if (configError.value)
return []
const guide = buildConnectionGuide(url)
return [
{ title: 'Codex · ~/.codex/config.toml', code: guide.codex },
{ title: 'Claude Code · .mcp.json', code: guide.claudeCode },
{ title: 'Другой HTTP-клиент', code: guide.generic },
]
})

async function copy(value: string): Promise<void> {
copyError.value = null
copied.value = false
try {
await navigator.clipboard.writeText(value)
copied.value = true
}
catch {
copyError.value = 'Не удалось скопировать инструкцию. Выделите текст вручную.'
}
}
</script>

<template>
<div class="space-y-4">
<h3 class="text-sm font-medium">
Подключение агента
</h3>
<p class="text-sm text-muted-foreground">
Сервер MCP: <code class="break-all">{{ url }}</code>
</p>
<p v-if="configError" class="text-sm text-destructive" role="alert">
{{ configError }}
</p>
<template v-else>
<p class="text-sm text-muted-foreground">
Добавьте секцию Codex в ~/.codex/config.toml или запись alfy в mcpServers файла .mcp.json в корне проекта Claude Code. Существующие настройки сохраните. Выполните команды ниже в Bash или Zsh, затем вставьте токен и нажмите Enter: ввод скрыт и не попадает в историю команд. Запустите агента из этого же терминала; в Claude Code проверьте подключение командой /mcp. Конфигурации используют переменную ALFY_MCP_TOKEN.
</p>
<pre class="overflow-x-auto rounded-md bg-muted p-3 text-xs"><code>export ALFY_MCP_TOKEN
read -rs ALFY_MCP_TOKEN</code></pre>
<div v-for="item in examples" :key="item.title" class="space-y-2">
<div class="flex items-center justify-between gap-2">
<h4 class="text-sm font-medium">
{{ item.title }}
</h4>
<Button type="button" variant="outline" size="sm" @click="copy(item.code)">
Копировать
</Button>
</div>
<pre class="overflow-x-auto rounded-md bg-muted p-3 text-xs whitespace-pre-wrap break-all"><code>{{ item.code }}</code></pre>
</div>
<p v-if="copyError" class="text-sm text-destructive" role="alert">
{{ copyError }}
</p>
<p v-if="copied" class="text-sm text-emerald-600" aria-live="polite">
Инструкция скопирована
</p>
</template>
</div>
</template>
Loading
Loading