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.

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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

Angle One MCP Server
baba786
-
security
F
license
-
quality
An MCP server implementation that integrates with Angle One APIs to provide standardized access to financial market data, trading operations, and portfolio management.
Last updated -
Python
AlphaVantage MCP Server
lifejwang11
-
security
A
license
-
quality
An MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.
Last updated -
Python
MIT License
Alpha Vantage MCP Server
deepsuthar496
A
security
F
license
A
quality
An MCP server that provides real-time financial data integration with Alpha Vantage's API, enabling access to stock market data, cryptocurrency prices, forex rates, and technical indicators.
Last updated -
7
2
JavaScript
CoinStats MCP Serverofficial
CoinStatsHQ
A
security
A
license
A
quality
MCP Server for the CoinStats API. Provides access to cryptocurrency market data, portfolio tracking, and news.
Last updated -
30
89
3
TypeScript
MIT License

View all related MCP servers

Marketstack MCP Server