MCP1

Удаленный MCP-сервер, предоставляющий учебную программу по психологии инвестора Doggi (Careful Starter) в виде 7 инструментов. Создан для того, чтобы Claude извлекал только нужный фрагмент урока за один запрос, вместо того чтобы повторно считывать весь корпус данных.

Структура

Related MCP server: fallscout-mcp

Локальный запуск

# Smoke test, no API key needed
python3 tests/demo.py

# Run the HTTP server locally
MCP_API_KEY=test pip install -r requirements.txt
MCP_API_KEY=test python3 http_server.py
curl -H "X-API-Key: test" http://localhost:8000/mcp

# Live coaching client (needs ANTHROPIC_API_KEY + COACHING_MODEL)
python3 coaching_session.py

Развертывание

См. DEPLOY.md — Fly.io, примерно 20 минут от начала до конца.

Инструменты

1. get_lesson(n) — урок 1–6

2. get_framework() — путеводная звезда

3. get_archetype_triggers() — триггеры Doggi, красные флаги, сильные стороны

4. get_coaching_intervention(n) — стиль коучинга, что делать/не делать, пример для урока n

5. get_progress_state() — на каком этапе пути находится клиент

6. analyze_response(text, n) — сопоставление текста пользователя с триггерами и красными флагами

7. next_lesson(n) — последовательность

Настройка

Все находится в data/ и lessons/. Редактируйте, делайте коммит, fly deploy. Изменение кода не требуется.

• lessons/lesson{1-6}.md — содержание урока

• data/archetype.json — триггеры, красные флаги, сильные стороны

• data/interventions.json — стиль коучинга для каждого урока

• data/progress_state.json — состояние клиента (в продакшене замените на запрос к БД)

Заметки по проектированию

• Не добавляйте этот README (или другие документы) в пространство проекта Claude. Если Claude читает это при каждом запросе, теряется смысл MCP.

• Не прописывайте жестко устаревшие ID моделей. coaching_session.py считывает COACHING_MODEL из переменных окружения.

• Источник истины находится на диске, а не в коде. Никаких встроенных копий.

• Описания инструментов намеренно короткие (≤6 слов). Схемы описывают входные данные.

• Аутентификация по API-ключу обязательна. http_server.py отказывается запускаться без MCP_API_KEY.

Безопасность

• API-ключ требуется для всех запросов /mcp через заголовок X-API-Key

• /health открыт (Fly.io нужен для проверок работоспособности)

• Обход путей заблокирован: lesson_num проверяется как целое число 1–6 перед любым доступом к файлу

• Размер входных данных ограничен: analyze_response отклоняет полезные нагрузки более 10 КБ

• Контейнер работает от имени пользователя без прав root

• Никаких секретов в исходном коде — MCP_API_KEY и ANTHROPIC_API_KEY берутся только из переменных окружения

• .gitignore и .dockerignore исключают .env* и другие шаблоны секретных файлов