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 Web アプリを実行

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（ツール説明に埋め込むガイド）+ context_state（複数ターンにわたる日付・銘柄の carry-forward、一般化）。

• mcp_server/ — 実際の MCP サーバーで、core/ を外部の AI クライアントに公開します。

• webapp/ — BYOK Web チャットで、MCP サーバーと core/ を共有します（ケースのずれを防ぎます）。

検証済み

• tests/regression_cases.py: 24/24 パス — tool registry は 29 ツールすべてを備え、ガイドの埋め込み、コンテキストの carry-forward が正しい（本日旧システム側で修正したバグのケース）、数値フォーマッタも正確です。

• MCP サーバー: MCP プロトコルを通じた実際のラウンドトリップ（インメモリのクライアント/サーバー）— 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 を参照）。