Trader MCP - Project

Purpose

Trading helpers, strategy control, and a small MCP surface. Keep app logic isolated and the public API compact.

Architecture

FastAPI app
FastMCP mounted at /mcp using SSE at /mcp/sse
App-specific logic under src/<app_name>/*
State persistence via SQLite (add only as needed)
Logs and pid files under ./logs/

MCP surface

list_strategies
get_strategy
update_strategy
control_strategy

Notes

get_strategy() can optionally include render and debug data.
update_strategy() updates config/state and reconciles.
control_strategy() handles start, pause, resume, stop, and reconcile.

Upgrade plans

The next phase should focus on making trader easier to operate, not just more capable:

standardize a shared config vocabulary across strategies
streamline how strategies appear in the dashboard and how they are configured
add more render widgets where they improve clarity, such as candle and line charts
keep the debug log useful, but visually lighter when possible
extend the strategy set only once the shared config and display model are clean

Routes

GET / minimal landing page
GET /health liveness
GET /mcp/sse MCP SSE endpoint