MCP Avantage

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 (empfohlen): Ü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 Fallback: 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.)