Bcs MCP

🚀 BCS-MCP

這是一個自主的MCP服務，用於將 BCS Trade API 與大語言模型（LLM）集成。該服務收集市場和私有數據，將其存儲在PostgreSQL/pgvector中，並通過MCP提供相關工具。

✨ 主要特性

📈 數據與存儲

• 市場數據流：包含行情報價、訂單簿、交易記錄、K線等。
• 私有數據：涵蓋投資組合、委託單、交易記錄、交易限制等。
• 數據按模式劃分：
  • bcs_market：用於存儲市場數據。
  • bcs_private：用於存儲私有數據。

🧠 支持大語言模型的層

• 基於嵌入向量的語義搜索：通過嵌入向量（默認使用llm_mcp，Ollama作為備用）對歷史數據進行語義搜索。
• 決策日誌和上下文：記錄決策日誌和上下文，方便後續分析。
• 本地優先策略：儘可能在數據庫或腳本端進行計算，減少大語言模型的令牌使用。

🧮 腳本與信號

• 內置數學腳本：包含簡單移動平均線（SMA）、指數移動平均線（EMA）、相對強弱指數（RSI）、手續費、交易時段、風險計算等腳本。
• 腳本目錄與服務器計算：提供腳本目錄，可在服務器端進行計算，避免將原始數據序列輸出到大語言模型。
• 信號保存與增強：signals.run 可保存啟發式信號，並增強 direction.llm（無需遷移模式）。

🧱 架構

• server/：Node.js MCP服務器（包含工具和HTTP端點）
• worker/：Python數據攝取、數據流處理和嵌入向量生成
• db/init/：SQL初始化和數據庫模式

一個容器（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：嵌入向量模型
• LLM_BACKEND=llm_mcp|ollama, LLM_MCP_BASE_URL, LLM_MCP_PROVIDER, LLM_BACKEND_FALLBACK_OLLAMA

🧰 MCP工具（分組）

• market.*：數據查詢、最新數據、聚合數據、快照、計算等操作
• private.*：投資組合、交易記錄、盈虧計算、決策等操作
• selected_assets.*：關注列表操作
• embedding.*：隊列管理和搜索操作
• scripts.*, signals.run：本地計算操作
• bcs.*：直接調用BCS REST API

📚 詳細文檔

• 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 文件中。