MCP-Server für Alpha Vantage API (@missionsquad/avantage)

Dieses Projekt stellt einen Model Context Protocol (MCP)-Server bereit, der die @missionsquad/avantage -Bibliothek umschließt und Alpha Vantage API-Funktionen als Tools für Language Learning Models (LLMs) bereitstellt.

Überblick

Dieser Server ermöglicht LLMs die Interaktion mit der Alpha Vantage API, um Finanzdaten abzurufen, darunter:

• Kernaktiendaten (Zeitreihen, Kurse, Suche)

• Fundamentaldaten (Unternehmensübersicht, Finanzdaten, Kalender)

• Forex (FX) Daten

• Kryptowährungsdaten

• Rohstoffdaten

• Wirtschaftsindikatoren

• Technische Indikatoren

• Alpha Intelligence (Nachrichten, Stimmungen usw.)

• Optionsdaten (Premium)

Es nutzt die TypeScript-Bibliothek @missionsquad/avantage und folgt der Architektur der generischen MCP-Servervorlage, einschließlich der Handhabung von API-Schlüsseln für mehrere Benutzer und der Ressourcenverwaltung für AVantage Clientinstanzen.

Hauptmerkmale:

• Umfassende Abdeckung: Implementiert MCP-Tools für fast alle in der Bibliothek @missionsquad/avantage verfügbaren Funktionen.

• Mehrbenutzerunterstützung: Verarbeitet Alpha Vantage-API-Schlüssel sicher über extraArgs (bevorzugt) oder durch Fallback auf Umgebungsvariablen.

• Ressourcenverwaltung: Verwaltet AVantage Clientinstanzen effizient mithilfe des ResourceManager .

• Stark typisiert: Erstellt mit TypeScript, nutzt Typen aus @missionsquad/avantage und Zod-Schemas für Toolparameter.

• Standard-MCP-Schnittstelle: Verwendet @missionsquad/fastmcp für die MCP-Kommunikation.

Erste Schritte

Voraussetzungen

• Node.js v20 oder höher

• npm oder yarn

• Ein Alpha Vantage API-Schlüssel ( hier einen erhalten)

Aufstellen

1. Klonen oder Kopieren: Klonen Sie dieses Repository oder kopieren Sie die Dateien.

   git clone <repository-url> mcp-avantage-server cd mcp-avantage-server

2. Abhängigkeiten installieren:

   npm install # or yarn install

3. Umgebung konfigurieren:

   • Kopieren Sie .env.example nach .env .

   • Bearbeiten Sie .env und setzen Sie API_KEY auf Ihren Alpha Vantage API-Schlüssel.

   • Legen Sie optional AV_PREMIUM=true , wenn Sie ein Premium-Abonnement haben.

   • Passen Sie LOG_LEVEL oder RESOURCE_CLEANUP_INTERVAL bei Bedarf an.

4. Erstellen Sie das Projekt:

   npm run build # or yarn build

5. Starten Sie den Server:

   npm start # or yarn start

   Der Server wartet auf MCP-Anfragen auf stdio.

Authentifizierung

Der Server verwendet das Standardmuster zur Token-Behandlung mehrerer Benutzer:

1. extraArgs.apiKey Übergeben Sie den benutzerspezifischen Alpha Vantage API-Schlüssel im Feld apiKey des extraArgs -Objekts während der MCP call_tool Anforderung. Dieser Schlüssel ist nicht Teil des Tool-Schemas.

2. .env Wenn extraArgs.apiKey nicht angegeben ist, verwendet der Server den API_KEY -Wert aus der .env Datei.

Verfügbare Tools

Dieser Server stellt zahlreiche Tools bereit, die den Methoden in der Bibliothek @missionsquad/avantage entsprechen. Die Tools werden im Allgemeinen als module_method bezeichnet (z. B. coreStock_intraday , fundamentalData_companyOverview ).

Weitere Informationen zu Parametern und Rückgabestrukturen finden Sie in der Alpha Vantage-Dokumentation und in den Typen der Bibliothek @missionsquad/avantage ( src/types/* innerhalb der Bibliothek).

Beispiel eines Tool-Aufrufs (konzeptionelle MCP-Anforderung):

Werkzeugkategorien (Module):

• alphaIntelligence_*

• commodities_*

• coreStock_*

• crypto_*

• economicIndicators_*

• forex_*

• fundamentalData_*

• optionsData_* (Premium)

• technicalIndicators_*

Verwenden Sie den MCP-Befehl list_tools , um die vollständige Liste der verfügbaren Tools, deren Beschreibungen und Parameterschemata abzurufen.

Konfiguration

Konfigurieren Sie über .env -Datei:

Projektstruktur

Folgt der generischen MCP-Server-Vorlagenstruktur. Schlüsseldateien:

• src/index.ts : Haupteinstiegspunkt des Servers, Tooldefinitionen.

• src/config.ts : Konfiguration wird geladen.

• src/logger.ts : Protokollierungsprogramm.

• src/resource-manager.ts : Verwaltet AVantage Instanzen.

• src/schemas.ts : Zod-Schemas für Toolparameter.

• .nexus/ : Nexus-Dokumentation.

Nexus-Dokumentation

• .nexus/features/avantage_integration/feature.md

• .nexus/architecture/server_structure.md

• .nexus/guides/using_avantage_tools.md

• .nexus/decisions/decision_log.md

Lizenz

MIT (Vorausgesetzt, die Vorlagenlizenz ist MIT. Überprüfen.)