How do I use trading-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@trading-mcp Show me the MACD and last 50 candlesticks for symbol 000001" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

trading-mcp

Foundational trading utilities powered by uv, pydantic, akshare, and TA-Lib.

Setup

Install dependencies with uv:

uv sync --extra dev

TA-Lib requires a native system library. Install it before syncing:

macOS: brew install ta-lib
Debian/Ubuntu: sudo apt-get install libta-lib0 libta-lib0-dev
Windows: use a prebuilt wheel for your Python version

Configuration

Settings are validated with pydantic and can be overridden via environment variables using the TRADING_MCP_ prefix:

export TRADING_MCP_ENVIRONMENT=dev export TRADING_MCP_DATA_DIR=./data export TRADING_MCP_DEFAULT_SYMBOL=000001

Usage

from trading_mcp.config import Settings from trading_mcp.data import AkshareMarketDataClient from trading_mcp.indicators import IndicatorEngine settings = Settings(environment="dev", data_dir="./data", default_symbol="000001") client = AkshareMarketDataClient() frame = client.fetch(settings.default_symbol, "2024-01-01", "2024-02-01") engine = IndicatorEngine() close_series = frame["close"] if "close" in frame.columns else frame.iloc[:, 0] result = engine.compute("sma", close_series, timeperiod=5) print(result.tail())

MCP Server

Start the MCP server with streamable HTTP transport:

export TRADING_MCP_HOST=0.0.0.0 export TRADING_MCP_PORT=8000 python main.py

Available tools:

kline(symbol, limit) → OHLCV bar list
macd(symbol, limit, fast_period=12, slow_period=26, signal_period=9) → MACD series
rsi(symbol, limit, period=14) → RSI series
ma(symbol, limit, period=20, ma_type="sma") → moving average series