stocktraders-mcp

기존 chatbotgpt/chatbotgpt와 완전히 독립적으로 병행 운영됩니다 — 코드도 공유하지 않고, DB도 공유하지 않으며, 실행 중인 시스템에는 전혀 건드리지 않습니다.

설치

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, 조용히 공용 키로 폴백하지 않습니다.

아키텍처

자세한 내용은 core/*.py 파일 시작 부분의 docstring을 참고하세요 — 각 파일은 기존 시스템의 어떤 구성 요소를 대체하는지, 왜 그런지 명시합니다.

• core/ — tool registry + executor (기존 코드에서 1:1 포팅) + formatters (정확한 수치) + knowledge (tool description에 임베드되는 가이드) + context_state (다회차 날짜/종목 코드 carry-forward, 일반화).

• mcp_server/ — 실제 MCP 서버로, 외부 AI 클라이언트에 core/를 노출합니다.

• webapp/ — BYOK 웹 채팅으로, MCP 서버와 core/를 공유합니다 (케이스 차이 없음 보장).

검증 완료

• tests/regression_cases.py: 24/24 pass — tool registry가 29개 도구를 모두 갖추고, 가이드 임베드가 올바르며, 컨텍스트 carry-forward가 정확하고 (오늘 기존 시스템에서 수정한 버그 케이스), formatter 수치가 정확합니다.

• MCP 서버: MCP 프로토콜을 통한 실제 round-trip (인메모리 클라이언트/서버) — 30개 도구 나열 (29 + searchCaseIdeas), getAnalyzeWave가 "큰 파도인지 반등 파동인지" 가이드를 올바르게 전달합니다.

• Webapp: 실제 uvicorn 실행, /health, /auth/key, /auth/key/status, /chat 테스트 (키가 없을 때 올바르게 거부).

아직 안 한 작업 (실제 OpenAI 키 + 실제 시간으로 검증 필요)

• Claude Desktop/MCP inspector를 통해 원본 규칙 문서의 11개 케이스로 실제 대화 테스트.

• 실제 OpenAI 키로 webapp을 통한 실제 대화 테스트, 기존 버전과 문장별 대조.

• VPS에 배포 (현재 프로덕션은 chatbotgpt/chatbotgpt이며, 이 프로젝트는 아직 배포된 적 없음).

• 이전 case_ideas 마이그레이션 (의도적으로 자동화하지 않음 — plan 참고).