stocktraders-mcp

Parallel, völlig unabhängig vom alten chatbotgpt/chatbotgpt — kein Code-Sharing, keine gemeinsame DB, keinerlei Eingriff in das laufende System.

Installation

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

Regressionstest ausführen (muss vor jeder Änderung in core/ ausgeführt werden)

python tests/regression_cases.py

MCP-Server ausführen (damit Claude Desktop / ChatGPT / Cursor sich verbinden können)

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

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

Web-App mit BYOK ausführen

uvicorn webapp.main:app --port 8000

Ablauf:

1. POST /auth/key {"user_id": "...", "openai_api_key": "sk-..."} — der Benutzer speichert seinen eigenen Key.

2. POST /chat {"user_id": "...", "message": "..."} — verwendet genau den gespeicherten Key, nicht den Firmen-Key.

3. Kein Key vorhanden → 400, kein stilles Fallback auf einen gemeinsamen Key.

Architektur

Details siehe im Docstring am Anfang jeder Datei in core/*.py — jede Datei gibt an, welche Komponente des alten Systems sie ersetzt und warum.

• core/ — Tool-Registry + Executor (1:1 vom alten Code portiert) + Formatter (präzise Zahlen) + Knowledge (Guide eingebettet in die Tool-Beschreibung) + context_state (Carry-Forward von Datum/Symbol über mehrere Turns, verallgemeinert).

• mcp_server/ — echter MCP-Server, der core/ für externe AI-Clients bereitstellt.

• webapp/ — Web-Chat mit BYOK, nutzt core/ gemeinsam mit dem MCP-Server (stellt sicher, dass die Fälle nicht auseinanderlaufen).

Verifiziert

• tests/regression_cases.py: 24/24 bestanden — Tool-Registry vollständig mit 29 Tools, Guides korrekt eingebettet, Carry-Forward des Kontexts korrekt (der Bug-Fall wurde heute im alten System behoben), Formatter liefern präzise Zahlen.

• MCP-Server: echter Round-Trip über das MCP-Protokoll (In-Memory-Client/Server) — listet 30 Tools (29 + searchCaseIdeas), getAnalyzeWave enthält den korrekten Guide „große Welle oder Erholungswelle".

• Web-App: echten uvicorn gestartet, /health, /auth/key, /auth/key/status, /chat getestet (korrekte Ablehnung, wenn noch kein Key vorhanden ist).

Noch nicht erledigt (erfordert echten OpenAI-Key + reale Zeit zur Verifizierung)

• Echte Konversationstests über Claude Desktop/MCP inspector mit den 11 Fällen des ursprünglichen Regel-Dokuments.

• Echte Konversationstests über die Webapp mit echtem OpenAI-Key; jeder Satz wird mit der alten Version abgeglichen.

• Deployment auf den VPS (die aktuelle Produktion ist chatbotgpt/chatbotgpt, dieses Projekt wurde noch nirgendwo deployed).

• Alte case_ideas migrieren (bewusst nicht automatisch — siehe Plan).