mcp-market-server

Servidor MCP (Model Context Protocol) que expone datos de mercado de criptomonedas en vivo y un motor de paper trading como llamadas a herramientas estandarizadas — para que cualquier agente (Claude Code, sistemas multiagente personalizados) pueda consultar Bybit y ejecutar operaciones simuladas.

Construido para la candidatura de becario de IA/ML en Tower Research Capital: demuestra integración con MCP, invocación de herramientas por agentes, controles de riesgo y Python con estándares de producción.

Arquitectura

┌─────────────┐     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

Herramientas expuestas

Protecciones de riesgo (motor de paper trading)

• Nocional máximo por orden (risk.max_order_notional_usd)

• Máximo de posiciones abiertas (risk.max_open_positions)

• Límite de pérdida diaria — el trading se desactiva cuando la pérdida diaria supera el límite

• Cada orden y cada decisión quedan registradas en una tabla de auditoría

Configuración

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

Registro con Claude Code

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

O con la CLI:

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

Prompts de demostración (después de registrarse)

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.

Notas de diseño

• Solo endpoints públicos — sin claves API y sin dinero real. El motor de paper trading ejecuta órdenes de mercado contra el precio del ticker en vivo y realiza órdenes límite cuando el precio toca el nivel.

• SQLite para órdenes, posiciones, operaciones y auditoría — persistencia sin dependencias, igual que cómo las mesas de los quants registran cada decisión.

• La capa de riesgo se sitúa entre las herramientas y el motor — el mismo patrón que en una mesa de negociación real: la estrategia propone, el riesgo dispone.