stocktraders-mcp

Параллельный и полностью независимый от старого chatbotgpt/chatbotgpt — без общего кода, без общей БД, не затрагивает работающую систему.

Установка

python -m venv .venv
.venv\Scripts\activate        # Windows
pip install -r requirements.txt
copy .env.example .env        # rồi điền BYOK_ENCRYPTION_KEY

Related MCP server: Rozkoduj MCP

Запуск регрессионных тестов (обязательно запускать перед любыми изменениями в core/)

python tests/regression_cases.py

Запуск MCP-сервера (для подключения Claude Desktop / ChatGPT / Cursor)

# stdio (Claude Desktop, MCP inspector)
python -m mcp_server.server

# HTTP (client từ xa)
python -m mcp_server.server --http --port 8100

Запуск веб-приложения BYOK

uvicorn webapp.main:app --port 8000

Порядок действий:

1. POST /auth/key {"user_id": "...", "openai_api_key": "sk-..."} — пользователь сам сохраняет свой собственный ключ.

2. POST /chat {"user_id": "...", "message": "..."} — используется именно сохранённый ключ, ключ компании не затрагивается.

3. Нет ключа → 400, без тихого переключения на общий ключ.

Архитектура

Подробности см. в docstring в начале каждого файла в core/*.py — каждый файл указывает, какой компонент старой системы он заменяет и почему.

• core/ — tool registry + executor (порт 1:1 из старого кода) + formatters (точные числовые данные) + knowledge (инструкции, встроенные в описание инструментов) + context_state (перенос даты/кода между ходами, обобщение).

• mcp_server/ — настоящий MCP-сервер, предоставляющий core/ внешним AI-клиентам.

• webapp/ — веб-чат BYOK, использующий общий core/ с MCP-сервером (чтобы сценарии не расходились).

Проверено

• tests/regression_cases.py: 24/24 pass — реестр инструментов содержит все 29 инструментов, инструкции встроены правильно, перенос контекста корректен (случай с багом, исправленным сегодня в старой системе), форматтер числовых данных точен.

• MCP-сервер: реальный round-trip по протоколу MCP (in-memory client/server) — список из 30 инструментов (29 + searchCaseIdeas), getAnalyzeWave содержит правильную инструкцию «большая волна или волна отката».

• Webapp: запущен реальный uvicorn, протестированы /health, /auth/key, /auth/key/status, /chat (корректный отказ при отсутствии ключа).

Не сделано (требуется настоящий ключ OpenAI + реальное время для проверки)

• Тестирование реального диалога через Claude Desktop/MCP inspector на 11 случаях из исходного документа правил.

• Тестирование реального диалога через webapp с настоящим ключом OpenAI, сверка каждого ответа со старой версией.

• Деплой на VPS (текущий продакшн — chatgpt/chatgpt? нет, chatbotgpt/chatbotgpt, этот проект ещё никуда не задеплоен).

• Миграция старых case_ideas (осознанно не автоматическая — см. план).