mcp-market-server

MCP-Server (Model Context Protocol), der Live-Kryptomarktdaten und eine Paper-Trading-Engine als standardisierte Tool-Aufrufe bereitstellt – so kann jeder Agent (Claude Code, benutzerdefinierte Multi-Agenten-Systeme) Bybit abfragen und simulierte Trades ausführen.

Entwickelt für die Bewerbung um ein AI/ML-Praktikum bei Tower Research Capital: demonstriert MCP-Integration, Tool-Aufrufe durch Agenten, Risikokontrollen und produktionsorientierten Python.

Architektur

┌─────────────┐     MCP stdio      ┌──────────────────┐    REST     ┌─────────┐
│ Claude Code │ ◄───────────────► │  FastMCP Server  │ ─────────►  │  Bybit  │
│   / Agent   │                    │  (tools.py)      │  public API │   v5    │
└─────────────┘                    └────────┬─────────┘             └─────────┘
                                            │
                                   ┌────────▼─────────┐
                                   │  Paper Engine    │
                                   │  SQLite + Risk   │
                                   └──────────────────┘

Related MCP server: Data Puller MCP Server

Bereitgestellte Tools

Risikokontrollen (Paper-Engine)

• Maximales Notional pro Order (risk.max_order_notional_usd)

• Maximale offene Positionen (risk.max_open_positions)

• Tagesverlust-Stopp – der Handel wird deaktiviert, sobald der Tages-Drawdown das Limit überschreitet

• Jede Order und jede Entscheidung wird in eine Audit-Log-Tabelle geschrieben

Einrichtung

cd mcp-market-server
python -m venv .venv && .venv\Scripts\activate     # Windows
pip install -e ".[dev]"
cp .env.example .env                                # optional overrides
pytest                                              # run tests

Bei Claude Code registrieren

{
  "mcpServers": {
    "market": {
      "command": "python",
      "args": ["-m", "mcp_market_server.server"],
      "cwd": "/absolute/path/to/mcp-market-server"
    }
  }
}

Oder mit der CLI:

claude mcp add market -- python -m mcp_market_server.server

Demo-Prompts (nach der Registrierung)

Fetch the last 100 hourly candles for BTCUSDT and summarize the trend.

Place a paper long of 0.01 BTCUSDT with a 2% stop loss and take profit at 3%.

Show my account, then flatten everything if unrealized PnL is worse than -$50.

Design-Hinweise

• Nur öffentliche Endpunkte – keine API-Schlüssel, kein echtes Geld. Die Paper-Engine führt Markt-Orders zum Live-Ticker-Kurs aus, Limit-Orders bei Kursberührung.

• SQLite für Orders/Positionen/Trades/Audit – Persistenz ohne Abhängigkeiten; spiegelt wider, wie Quant-Desks jede Entscheidung protokollieren.

• Die Risikoschicht sitzt zwischen Tools und Engine – dasselbe Muster wie an einem echten Desk: Die Strategie schlägt vor, das Risikomanagement entscheidet.