Massive.com MCP-Server

Ein Model Context Protocol (MCP)-Server, der Zugriff auf die vollständige Massive.com Finanzdaten-API über eine LLM-freundliche Schnittstelle bietet.

Anstatt ein Tool pro Endpunkt bereitzustellen, bietet dieser Server dem LLM drei kombinierbare Tools — search, call und query —, die die gesamte Massive.com API-Oberfläche abdecken. Daten können in einer In-Memory-SQLite-Datenbank gespeichert und mit integrierten Finanzfunktionen angereichert werden.

Tools

Integrierte Funktionen

Funktionen können über den apply-Parameter bei call_api und query_data auf API-Ergebnisse oder Abfrageausgaben angewendet werden. Verwenden Sie search_endpoints mit scope="functions", um diese zu entdecken.

Datenabdeckung

Der Server indiziert beim Start dynamisch alle Massive.com API-Endpunkte von llms.txt, sodass er automatisch mit der API synchron bleibt. Die Abdeckung umfasst:

• Aktien-, Options-, Forex-, Krypto- und Futures-Aggregate

• Echtzeit- und historische Trades und Kurse

• Markt-Snapshots, Gewinner/Verlierer

• Ticker-Details und Referenzdaten

• Dividenden, Splits, IPOs

• Finanzielle Fundamentaldaten

• Analystenbewertungen und Nachrichten (Benzinga)

• Staatsanleiherenditen, Inflationsdaten

• Marktstatus und Feiertage

Related MCP server: Dingo MCP Server

Installation

Voraussetzungen

• Python 3.12+

• Ein Massive.com API-Schlüssel

• Astral UV (v0.4.0+)

Claude Code

Installieren Sie zuerst Claude Code

npm install -g @anthropic-ai/claude-code

Installieren Sie den MCP-Server und registrieren Sie ihn dann bei Claude Code:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

Um später auf eine neue Version zu aktualisieren:

uv tool upgrade mcp_massive

Dieser Befehl installiert den MCP-Server in Ihrem aktuellen Projekt. Wenn Sie ihn global installieren möchten, können Sie den Befehl mit dem Flag -s <scope> ausführen. Siehe claude mcp add --help für weitere Optionen.

Um Claude Code zu starten, führen Sie claude in Ihrem Terminal aus.

• Wenn Sie es zum ersten Mal verwenden, folgen Sie den Einrichtungsanweisungen zur Authentifizierung

Sie können auch claude mcp add-from-claude-desktop ausführen, falls der MCP-Server bereits für Claude Desktop installiert ist.

Claude Desktop

1. Befolgen Sie die Claude Desktop MCP-Installationsanweisungen, um die Erstinstallation abzuschließen und Ihre Konfigurationsdatei zu finden.

2. Installieren Sie den Server:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

3. Suchen Sie den Pfad der installierten Binärdatei:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Fügen Sie den Server zu Ihrer Claude Desktop-Konfiguration hinzu. Ersetzen Sie <path_to_mcp_massive> durch die Ausgabe des vorherigen Schritts und füllen Sie die verbleibenden Felder aus.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

Konfiguration

Umgebungsvariablen

Transport

Standardmäßig wird der STDIO-Transport verwendet. Der Transport kann über das CLI-Argument --transport oder die Umgebungsvariable MCP_TRANSPORT festgelegt werden (das CLI-Argument hat Vorrang).

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

Anwendungsbeispiele

Sobald die Integration abgeschlossen ist, können Sie Claude auffordern, auf Massive.com-Daten zuzugreifen:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

Entwicklung

Lokal ausführen

Stellen Sie sicher, dass Sie die Voraussetzungen installiert haben.

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

Installieren Sie aus Ihrem lokalen Checkout und referenzieren Sie dann die Binärdatei direkt:

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Debugging

Für Debugging und Tests empfehlen wir die Verwendung des MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

Dies startet eine Browser-Oberfläche, in der Sie direkt mit Ihrem MCP-Server interagieren und Ein-/Ausgaben für jedes Tool sehen können.

Wählen Sie den Transporttyp STDIO in der Browser-UI mit dem Befehl uv und run mcp_massive als Argumente.

Code-Linting

Dieses Projekt verwendet just für allgemeine Entwicklungsaufgaben. Um Ihren Code vor dem Einreichen eines PR zu linten:

just lint

Dies führt ruff format und ruff check --fix aus, um Ihren Code automatisch zu formatieren und Linting-Probleme zu beheben.

Links

• Massive.com Dokumentation

• Model Context Protocol

• MCP Python SDK

Datenschutzrichtlinie

Dieser MCP-Server interagiert mit der API von Massive.com, um Marktdaten abzurufen. Alle Datenanfragen unterliegen der Datenschutzrichtlinie und den Nutzungsbedingungen von Massive.com.

• Massive.com Datenschutzrichtlinie: https://massive.com/legal/privacy

• Datenverarbeitung: Dieser Server speichert oder zwischenspeichert keine Benutzerdaten. Alle Anfragen werden direkt an die API von Massive.com weitergeleitet.

• API-Schlüssel: Ihr Massive.com API-Schlüssel wird nur zur Authentifizierung von Anfragen an deren API verwendet.

• User-Agent: API-Anfragen enthalten einen User-Agent-String, der die MCP-Serverversion enthält (z. B. MCP-Massive/0.x.y). Es werden keine personenbezogenen Daten übermittelt.

Mitwirken

Wenn Sie einen Fehler gefunden haben oder eine Idee für eine neue Funktion haben, diskutieren Sie diese bitte zuerst mit uns, indem Sie ein neues Issue einreichen. Wir werden innerhalb von maximal 3 Wochen auf Issues antworten. Wir sind auch offen für Freiwillige, wenn Sie einen PR für offene Issues einreichen möchten, aber bitte besprechen Sie dies vorher mit uns. PRs, die nicht mit einem bestehenden Issue verknüpft sind oder nicht vorab mit uns besprochen wurden, werden in der Regel abgelehnt.