Bcs MCP

🚀 BCS-MCP

このREADMEは、BCS-MCPというサービスに関する情報を提供しています。このサービスは、BCS Trade APIとLLMを統合するためのオートノマスMCPサービスです。

BCS Trade APIとLLMを統合するためのオートノマスMCPサービスです。このサービスは、市場データとプライベートデータを収集し、PostgreSQL/pgvectorに保存し、MCPを通じてツールを提供します。

✨ 主な機能

📈 データと保存

• 市場データ: 相場、板情報、取引、ロウソク足。
• プライベートデータ: ポートフォリオ、注文、取引、制限。
• データのスキーマ別分離:
  • bcs_market — 市場データ;
  • bcs_private — プライベートデータ。

🧠 LLM対応レイヤー

• embeddingsを使用した履歴の意味検索 (llm_mcp デフォルト、Ollamaフォールバック)。
• 意思決定のログと後続分析のためのコンテキスト。
• Local-firstアプローチ: データベース/スクリプト側での最大限の計算、LLMの最小限のトークン使用。

🧮 スクリプトとシグナル

• 組み込みの数学的スクリプト (SMA/EMA/RSI、手数料、セッション、リスク)。
• スクリプトのカタログと、LLMに生データを出力せずにサーバー側の計算を実行する機能。
• signals.run はheuristicシグナルを保存し、direction.llm を補完します (スキーマの移行なしでの強化)。

🧱 アーキテクチャ

• server/ — Node.js MCPサーバー (ツール + HTTPエンドポイント)
• worker/ — Pythonのデータ取り込み/ストリーム/embeddings
• db/init/ — SQLの初期化とスキーマ

1つのコンテナ (Dockerfile) にサーバーとワーカーが含まれています。

🚀 クイックスタート

cd bcs-mcp
cp .env.example .env
# BCS_REFRESH_TOKENを入力してください

docker compose -f compose.yml up -d

確認:

curl http://127.0.0.1:3332/health
curl http://127.0.0.1:3332/tools

🔧 重要な環境変数

• BCS_REFRESH_TOKEN — 必須のリフレッシュトークン
• BCS_CLIENT_ID — trade-api-read または trade-api-write
• BCS_ALLOW_WRITE — 取引操作の有効化
• BCS_DB_HOST — composeでは bcsdb
• BCS_DB_PORT — compose内のネットワークでは 5432
• MCP_PORT — コンテナ内のMCPポート (3333)、外部に公開されるポートは 3332
• OLLAMA_EMBED_MODEL — embeddingsモデル
• LLM_BACKEND=llm_mcp|ollama, LLM_MCP_BASE_URL, LLM_MCP_PROVIDER, LLM_BACKEND_FALLBACK_OLLAMA

🧰 MCPツール (グループ)

• market.* — データ選択、最新データ、集計、スナップショット、計算
• private.* — ポートフォリオ/取引/PnL/意思決定
• selected_assets.* — ウォッチリスト
• embedding.* — キューと検索
• scripts.*, signals.run — ローカル計算
• bcs.* — BCS RESTの直接呼び出し

📚 ドキュメント

• docs/bcs_api_reference.md — APIマップとMCPツール
• CHANGELOG.md — 変更履歴
• VERSION — モジュールの現在のバージョン

📁 構造

bcs-mcp/
├── server/
├── worker/
├── scripts/
├── db/init/
├── compose.yml
└── Dockerfile

🧭 公開Git標準

• VERSION のバージョンは YYYY.MM.x 形式で厳密に指定されます。
• すべての変更は CHANGELOG.md に記録されます。
• シークレットはgitに保存されません: .env.example のみ、実際の値はローカルの .env に保存されます。
• リリース前に docker compose config と基本的なスモークテスト (/health, /tools) が実行されます。

🔐 セキュリティ

• 取引アクションは BCS_ALLOW_WRITE=1 の場合のみ実行されます。
• HTTP MCPには MCP_HTTP_TOKEN を有効にすることができます。
• 実際のシークレットはローカルの .env にのみ保存されます。