Bcs MCP

🚀 BCS-MCP

An autonomous MCP service for integrating the BCS Trade API with LLM. The service collects market and private data, stores them in PostgreSQL/pgvector, and provides tools through MCP.

✨ Features

📈 Data and Storage

• Market streams: quotes, order books, trades, and candlesticks.
• Private data: portfolios, orders, trades, and limits.
• Data separation by schemas:
  • bcs_market — market data;
  • bcs_private — private data.

🧠 LLM-ready Layer

• Semantic search through history via embeddings (llm_mcp default, Ollama fallback).
• Decision logs and context for subsequent analysis.
• Local-first approach: maximum computations on the DB/scripts side, minimum LLM tokens.

🧮 Scripts and Signals

• Built-in mathematical scripts (SMA/EMA/RSI, commissions, sessions, and risks).
• A catalog of scripts and server-side calculations without outputting raw data series to LLM.
• signals.run saves heuristic signals and enriches direction.llm (enrichment without schema migration).

🧱 Architecture

• server/ — Node.js MCP server (tools + HTTP endpoints)
• worker/ — Python ingestion/streams/embeddings
• db/init/ — SQL initialization and schemas

One container (Dockerfile) contains the server and the worker.

🚀 Quick Start

cd bcs-mcp
cp .env.example .env
# Fill in BCS_REFRESH_TOKEN

docker compose -f compose.yml up -d

Verification:

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

🔧 Key Environment Variables

• BCS_REFRESH_TOKEN — Required refresh-token
• BCS_CLIENT_ID — trade-api-read or trade-api-write
• BCS_ALLOW_WRITE — Enable trading operations
• BCS_DB_HOST — In compose: bcsdb
• BCS_DB_PORT — Inside the compose network: 5432
• MCP_PORT — MCP port inside the container (3333), published externally as 3332
• OLLAMA_EMBED_MODEL — Embeddings model
• LLM_BACKEND=llm_mcp|ollama, LLM_MCP_BASE_URL, LLM_MCP_PROVIDER, LLM_BACKEND_FALLBACK_OLLAMA

🧰 MCP Tools (Groups)

• market.* — Selections, latest, aggregation, snapshots, and computations
• private.* — Portfolios/trades/PnL/decisions
• selected_assets.* — Watchlist
• embedding.* — Queue and search
• scripts.*, signals.run — Local calculations
• bcs.* — Direct calls to BCS REST

📚 Documentation

• docs/bcs_api_reference.md — API map and MCP tools
• CHANGELOG.md — Change history
• VERSION — Current module version

📁 Structure

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

🧭 Public Git Standards

• The version in VERSION must strictly follow the format YYYY.MM.x.
• All changes are recorded in CHANGELOG.md.
• Secrets are not stored in git: only .env.example, and working values are stored in the local .env.
• Before release, run docker compose config and basic smoke tests (/health, /tools).

🔐 Security

• Trading actions are only executed when BCS_ALLOW_WRITE=1.
• For HTTP MCP, you can enable MCP_HTTP_TOKEN.
• Real secrets are only stored in the local .env.