massive-mcp

Ein MCP-Server (Model Context Protocol), der die Massive.com REST Stocks API für Claude Desktop und Claude Code bereitstellt.

Erstellt mit FastMCP + httpx (async). Stdio-Transport.

Was wird abgedeckt

Die Standardeinstellungen sind darauf ausgelegt, Antworten klein zu halten (niedriges limit, Kürzung bei 200 Elementen mit einem _truncated_note). Alle paginierten Tools akzeptieren cursor und geben next_cursor aus, wenn weitere Daten verfügbar sind.

Installation

# Recommended: uv
uv tool install --from . massive-mcp
# or pipx
pipx install .

Für die Entwicklung:

uv sync --extra dev
uv run pytest

Konfiguration

Setzen Sie Ihren API-Schlüssel über die Umgebungsvariablen. Beide Authentifizierungsmodi werden unterstützt – beginnen Sie mit bearer; falls Massive mit 401 ablehnt, wechseln Sie zu query.

export MASSIVE_API_KEY=sk_live_...
export MASSIVE_AUTH_MODE=bearer   # or "query"

Oder kopieren Sie .env.example nach .env.

Einbindung

Claude Desktop

Bearbeiten Sie claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": ["massive-mcp"],
      "env": {
        "MASSIVE_API_KEY": "sk_live_...",
        "MASSIVE_AUTH_MODE": "bearer"
      }
    }
  }
}

Starten Sie Claude Desktop neu.

Claude Code

claude mcp add massive --env MASSIVE_API_KEY=sk_live_... --env MASSIVE_AUTH_MODE=bearer -- uvx massive-mcp

Lokale Entwicklung

uv run massive-mcp

Verwenden Sie den MCP Inspector, um die Tools manuell zu testen:

npx @modelcontextprotocol/inspector uvx massive-mcp

Ausprobieren

Sobald alles eingerichtet ist, können Sie Claude Dinge fragen wie:

• "Was war der Schlusskurs von NVDA am Vortag?"

• "Rufe die AAPL-Dividenden der letzten 12 Monate ab."

• "Zeige mir die Top 10 Gewinner im Moment."

• "Hole 5-Minuten-Balken für TSLA von gestern."

• "RSI für SPY über die letzten 30 Tage."

Begleitende Skill

Dieses Repo enthält auch eine Claude-Skill – massive-trade-analysis –, die die MCP-Tools nutzt, um professionelle Swing-/Langzeit-Handelspläne zu erstellen (Einstieg, SL, kaskadierte TPs, R:R, Positionsgrößenbestimmung). Siehe skills/ für Installationsanweisungen.

Hinweise & Einschränkungen

• Nur REST. Keine Unterstützung für WebSocket / FlatFiles.

• Nur Aktien-Anlageklasse. Optionen/FX/Krypto-Endpunkte sind für v1 nicht vorgesehen.

• Einige Endpunkte (/vX/...) werden von Massive als Beta versioniert – Pfade können sich ändern.

• 429-Antworten werden automatisch unter Berücksichtigung von Retry-After wiederholt. 5xx-Fehler werden mit exponentiellem Backoff wiederholt (maximal 3 Versuche).

• Der API-Schlüssel wird niemals protokolliert. Fehler entfernen apiKey aus der angezeigten URL.

Lizenz

MIT