stocktraders-mcp

En paralelo, totalmente independiente del antiguo chatbotgpt/chatbotgpt — no comparte código, no comparte base de datos, no toca el sistema en ejecución.

Instalación

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

Ejecutar pruebas de regresión (obligatorio ejecutar antes de cambiar cualquier cosa en core/)

python tests/regression_cases.py

Ejecutar servidor MCP (para que Claude Desktop / ChatGPT / Cursor se conecten)

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

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

Ejecutar la aplicación web BYOK

uvicorn webapp.main:app --port 8000

Flujo:

1. POST /auth/key {"user_id": "...", "openai_api_key": "sk-..."} — el usuario guarda su propia clave.

2. POST /chat {"user_id": "...", "message": "..."} — usa exactamente la clave guardada, no toca la clave de la empresa.

3. Sin clave → 400, sin fallback silencioso a la clave compartida.

Arquitectura

Ver detalles en el docstring inicial de core/*.py — cada archivo indica claramente qué componente del sistema antiguo sustituye y por qué.

• core/ — registro de herramientas + ejecutor (port 1:1 desde el código antiguo) + formateadores (datos precisos) + conocimiento (guía incrustada en la descripción de las herramientas) + context\_state (carry-forward de fecha/símbolo en múltiples turnos, generalizado).

• mcp_server/ — servidor MCP real, expone core/ a los clientes de IA externos.

• webapp/ — chat web BYOK, comparte core/ con el servidor MCP (garantiza que no haya desajustes de casos).

Verificado

• tests/regression_cases.py: 24/24 pasan — registro de herramientas completo con 29 herramientas, guía incrustada correcta, carry-forward de contexto correcto (caso de bug corregido hoy en el sistema antiguo), formateador de datos preciso.

• Servidor MCP: round-trip real a través del protocolo MCP (cliente/servidor en memoria) — lista 30 herramientas (29 + searchCaseIdeas), getAnalyzeWave incluye correctamente la guía "ola grande o ola de retroceso".

• Webapp: ejecuta uvicorn real, prueba /health, /auth/key, /auth/key/status, /chat (rechaza correctamente cuando no hay clave).

Pendiente (se necesita una clave real de OpenAI + tiempo real para verificar)

• Probar conversaciones reales a través de Claude Desktop/MCP inspector con los 11 casos de reglas del documento original.

• Probar conversaciones reales a través de la webapp con una clave real de OpenAI, comparando cada respuesta con la versión anterior.

• Desplegar en VPS (la producción actual es chatbotgpt/chatbotgpt, este proyecto aún no se ha desplegado en ningún sitio).

• Migrar los case_ideas antiguos (intencionadamente no automático — ver plan).