Marketstack MCP Server

Ein Model Context Protocol (MCP)-Server, der verschiedene Marketstack-API-Endpunkte als MCP-Tools bereitstellt und Zugriff auf Finanzdaten wie Tagesschluss-, Intraday-, Split-, Dividenden-, Ticker-, Börsen-, Währungs-, Zeitzonen-, Anleihen- und ETF-Daten bietet. Dieser Server vereinfacht die Integration von Marketstack-Daten in MCP-kompatible Agenten und Systeme.

Voraussetzungen

Node.js (v18 oder höher empfohlen)
npm (wird mit Node.js geliefert)
Marketstack-API-Schlüssel
(Optional) MCP-kompatibler Client oder Runner (z. B. VSCode-Erweiterung, CLI)

Aufstellen

Klonen Sie das Repository oder stellen Sie sicher, dass Sie sich im Projektverzeichnis befinden.
Installieren Sie Abhängigkeiten:
npm install
Konfiguration:
- Besorgen Sie sich einen Marketstack-API-Schlüssel von https://marketstack.com/ .
- Konfigurieren Sie die Umgebungsvariable MARKETSTACK_API_KEY über die Einstellungen Ihres MCP-Runners. Dies ist die empfohlene Methode für eine nahtlose Integration mit dem MCP-Client. Vermeiden Sie die Verwendung .env Dateien für diesen Zweck, wenn Sie über einen MCP-Runner laufen.

Bauen und Ausführen

Erstellen Sie den Server:
npm run build
Dadurch wird ein build -Verzeichnis mit dem kompilierten JavaScript-Code erstellt.
Führen Sie den Server aus:
npm run start
oder direkt:
node build/index.js
Via MCP-Runner: Konfigurieren Sie Ihren MCP-Client so, dass der Server per Standard-Transport ausgeführt wird. Beispiel für einen MCP-Einstellungseintrag (passen Sie /path/to/mcp-marketstack an Ihren tatsächlichen Pfad an und ersetzen Sie YOUR_API_KEY_HERE durch Ihren tatsächlichen Schlüssel):
"marketstack": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-marketstack/build/index.js" ], "env": { "MARKETSTACK_API_KEY": "YOUR_API_KEY_HERE" } // ... other optional settings ... }

Verfügbare Tools

Der Server stellt Marketstack-API-Endpunkte als unterschiedliche MCP-Tools bereit, die nach Funktion kategorisiert sind:

Marktdaten
Referenzdaten
Finanzinstrumente

Detaillierte Eingabeschemata und Beschreibungen für jedes Tool können von MCP-Agenten, die per Introspektion eine Verbindung zum Server herstellen, automatisch erkannt werden.

Projektstruktur

Das Projekt ist modular aufgebaut:

.
├── src/
│   ├── index.ts          # Server entry point
│   ├── marketstackClient.ts # Centralized API client with caching
│   ├── cacheConfig.ts    # Cache TTL configurations
│   └── tools/
│       ├── index.ts      # Registers all tool categories
│       ├── marketData/ # Market Data tools
│       │   └── ...
│       ├── referenceData/ # Reference Data tools
│       │   └── ...
│       ├── financialInstruments/ # Financial Instruments tools
│       │   └── ...
│       └── wrapToolHandler.ts # Wrapper for tool handlers
├── memory-bank/          # Project documentation
│   └── ...
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── eslint.config.js      # ESLint configuration
├── .prettierrc           # Prettier configuration
├── LICENSE               # Project license
└── README.md             # This file

Zwischenspeichern

Der Server implementiert einen LRU-Cache (Least Recently Used) für Tool-Antworten im Arbeitsspeicher. Dies trägt dazu bei, redundante Aufrufe der Marketstack-API zu reduzieren, die Leistung zu verbessern und Ratenbegrenzungen einzuhalten.

Mechanismus: Der Cache speichert Antworten basierend auf dem Toolnamen und den Eingabeparametern.
Konfigurierbare TTLs: Jedes Tool verfügt über eine konfigurierbare Time-to-Live (TTL) für seine zwischengespeicherten Daten, definiert in src/cacheConfig.ts . Dies ermöglicht unterschiedliche Caching-Dauern basierend auf der Aktualisierungshäufigkeit der von jedem Marketstack-Endpunkt bereitgestellten Daten.

Lizenzierung

Dieses Projekt ist unter der GNU General Public License der Free Software Foundation lizenziert, entweder in Version 3 oder (optional) einer späteren Version. Details finden Sie in der Datei LICENSE .

Beitragen

Beiträge sind willkommen! Bitte folgen Sie dem Standard-Workflow für Fork- und Pull-Anfragen.

Unterstützung

Bei Problemen oder Fragen öffnen Sie bitte ein Problem im GitHub-Repository.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Stellt verschiedene Marketstack-API-Endpunkte als MCP-Tools bereit und bietet Zugriff auf Finanzmarktdaten, darunter EOD, Intraday, Splits, Dividenden, Ticker, Börsen und andere Finanzinformationen.

Related MCP Servers

Financial Datasets MCP Serverofficial
financial-datasets
A
security
A
license
A
quality
MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
Last updated -
11
433
Python
MIT License
CoinMarketCap MCP
shinzo-labs
A
security
A
license
A
quality
A Model Context Protocol implementation for the CoinMarketCap API that provides standardized access to cryptocurrency market data, exchange information, and blockchain metrics.
Last updated -
26
225
28
JavaScript
MIT License
Binance Cryptocurrency MCP
snjyor
A
security
A
license
A
quality
MCP service that provides real-time access to Binance cryptocurrency market data, allowing AI agents to fetch current prices, order books, candlestick charts, and trading statistics through natural language queries.
Last updated -
12
390
24
JavaScript
Apache 2.0
Alpaca MCP Server
cesarvarela
A
security
F
license
A
quality
MCP server that exposes Alpaca Market Data & Broker API as tools, enabling access to financial data like stock bars, assets, market days, and news through the Message Control Protocol.
Last updated -
4
11
2
TypeScript

View all related MCP servers

Marketstack MCP Server