Finanzieller MCP-Server
Ein benutzerdefinierter Model Context Protocol (MCP)-Server für erweiterte Finanzanalysen, Aktienüberwachung und Marktinformationen in Echtzeit. Dieser Server bietet eine Reihe von Tools und API-Endpunkten für Portfoliomanagement, Marktübersichten, Aktienwarnungen und kontextbezogene Finanzinformationen und ist für die nahtlose Integration mit Claude Desktop und anderen MCP-kompatiblen Clients konzipiert.
Hauptmerkmale
- Echtzeitüberwachung von Aktienkursen : Verfolgen Sie Preisbewegungen für benutzerdefinierte Aktien und Schwellenwerte und erhalten Sie Warnmeldungen dazu.
- Portfolioverwaltung : Hinzufügen, Entfernen und Anzeigen verfolgter Aktien in einem dauerhaften Portfolio.
- Marktzusammenfassungen : Rufen Sie Live-Marktdaten aus aller Welt ab, darunter Indizes, Top-Gewinner/-Verlierer und Schlagzeilen.
- Kontextbezogene Finanzeinblicke : Analysieren Sie Benutzeranfragen, extrahieren Sie Finanzeinheiten, rufen Sie relevante Nachrichten ab, fassen Sie sie zusammen und generieren Sie umsetzbare Eingabeaufforderungen.
- Automatische Warnungen : Erhalten Sie Telegrammbenachrichtigungen zu Preisschwellen, Handelsmöglichkeiten und Systemfehlern.
- Anpassbare Konfiguration : JSON-basierte Sektor- und Bestandskonfiguration für flexible Alarmierung.
- Robuste Protokollierung und Fehlerbehandlung : Detaillierte Protokolle und Fehlermeldungen für Transparenz und Fehlerbehebung.
Systemübersicht
- Finanzkontext (Abfrage: str)
- Extrahiert Ticker und Schlüsselwörter aus einer Benutzerabfrage, ruft relevante Nachrichten ab, fasst sie zusammen und gibt einen strukturierten Kontext und eine Eingabeaufforderung für die nachgelagerte Analyse zurück.
- Marktzusammenfassung()
- Gibt eine Live-Zusammenfassung der globalen Märkte zurück, einschließlich Indizes, Top-Mover und Schlagzeilen.
- get_portfolio()
- Ruft die aktuelle Liste der verfolgten Aktien im Portfolio des Benutzers ab.
- Aktie hinzufügen(Ticker: str) / Aktie entfernen(Ticker: str)
- Fügen Sie eine Aktie zum Portfolio hinzu oder entfernen Sie sie daraus, mit Cache-Ungültigkeitserklärung und -Überprüfung.
- portfolio_alerts(random_string: str)
- Gibt alle ausgelösten Warnungen für das Portfolio oder für einen bestimmten Ticker zurück, sofern angegeben.
- check_stock_alerts(ticker: str) / single_stock_alert(ticker: str)
- Gibt Warnungen für eine bestimmte Aktie mit detaillierter Fehlerbehandlung zurück.
Automatisierte Alarmierung
- Telegram-Integration : Sendet formatierte Warnungen und Zusammenfassungen an einen konfigurierten Telegram-Chat.
- Handelsmöglichkeiten : Erkennt umsetzbare Handelssignale und meldet diese.
Kontextuelle Zusammenfassung
- News Summarizer : Verwendet ein lokales LLM (Ollama/Mistral), um detaillierte, mit Stimmungshinweisen versehene Zusammenfassungen von Finanznachrichtenartikeln zu erstellen.
- Prompt Builder : Erstellt eine marktorientierte Eingabeaufforderung zur Verwendung in nachgelagerten LLMs oder Assistenten.
Dateistruktur
config/
alerts_config.json # Main alert configuration (sector/ticker/thresholds)
tech_alerts_config.json # Tech sector-specific alerts
services/
alerts.py # Core alert logic
tech_alerts.py # Tech sector alert logic
telegram_alerts.py # Telegram integration
market_summary.py # Market data and news
summarizer.py # News summarization (LLM)
fetcher.py # Web data fetching
context_builder.py # Prompt/context construction
intent_parser.py # Financial entity extraction
portfolio.py # Portfolio management
server.py # MCP server entry point and API definitions
requirements.txt # Python dependencies
Konfiguration & Anpassung
Alarmkonfiguration ( config/alerts_config.json )
- Organisieren Sie Aktien nach Sektoren, mit anpassbaren oberen/unteren Preisschwellen und Beschreibungen.
- Beispielstruktur:
{
"Tech Giants": {
"AAPL": {"above": 200, "below": 180, "description": "Apple Inc."}
},
"Financial": {
"JPM": {"above": 160, "below": 140, "description": "JPMorgan Chase"}
}
}
Umgebungsvariablen
Legen Sie diese in einer .env Datei oder Ihrer Systemumgebung fest:
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
SERPAPI_API_KEY=your_serpapi_key
Installation und Ausführung von Claude Desktop
Voraussetzungen
- Python 3.7+
- Claude Desktop (oder jeder MCP-kompatible Client)
- Telegramm-Bot-Anmeldeinformationen (für Alarme)
- Internetverbindung (für Markt-/Nachrichtendaten)
Schritt-für-Schritt-Anleitung
- Klonen Sie das Repository
git clone <this-repo-url>
cd Finance_MCP_Server
- Erstellen und Aktivieren einer virtuellen Umgebung
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- Abhängigkeiten installieren
pip install -r requirements.txt
- Konfigurieren von Umgebungsvariablen
- Erstellen Sie im Projektstammverzeichnis eine
.env Datei mit Ihren API-Schlüsseln und Token:TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
SERPAPI_API_KEY=your_serpapi_key
- Alarmkonfigurationen bearbeiten
- Ändern Sie
config/alerts_config.json und config/tech_alerts_config.json um Ihre Aktien, Sektoren und Schwellenwerte festzulegen.
- Installieren Sie den MCP-Server mit der CLI
- Verwenden Sie die MCP-CLI, um den Server für Claude Desktop zu installieren und zu registrieren:
mcp install server.py --name "Financial MCP Server"
- Dadurch wird der Server als benutzerdefiniertes MCP-Tool registriert, sodass er von Claude Desktop und anderen MCP-Clients erkannt werden kann.
- Führen Sie den MCP-Server über die MCP-CLI aus
- Starten Sie den Server mithilfe der MCP-CLI:
- Der Server wird gestartet und wartet über stdio auf MCP-Anfragen.
- Verbindung von Claude Desktop
- Fügen Sie in Claude Desktop eine neue benutzerdefinierte MCP-Serververbindung hinzu.
- Legen Sie die ausführbare Datei/den Befehl auf
mcp run server.py fest (oder wählen Sie den registrierten „Financial MCP Server“ aus der MCP-CLI-Liste aus). - Claude Desktop kommuniziert über das MCP-Protokoll mit dem Server und aktiviert alle beschriebenen Tools und Endpunkte.
Beispiel: Claude Desktop MCP-Serverkonfiguration
Nach der Installation und Registrierung des Financial MCP Servers können Sie ihn zu Ihrer Claude Desktop-Konfiguration hinzufügen. Hier ist ein Beispiel für einen Ausschnitt aus der Datei claude_desktop_config.json :
{
"mcpServers": {
"Financial-MCP-Server": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"server.py"
],
"env": {
"SERPAPI_API_KEY": "",
"TELEGRAM_BOT_TOKEN": "",
"TELEGRAM_USER_ID": "",
"OPENAI_API_KEY": "",
"ALPHA_VANTAGE_API_KEY": ""
}
}
}
}
- Aktualisieren Sie den
env nach Bedarf mit Ihren tatsächlichen API-Schlüsseln und Token. - Diese Konfiguration stellt sicher, dass Claude Desktop Ihren Financial MCP Server mit der richtigen Umgebung und den richtigen Befehlszeilenargumenten starten und mit ihm kommunizieren kann.
Nach der Installation und Verbindung Ihres individuellen Financial MCP Servers werden alle verfügbaren Tools automatisch im Tool-Menü von Claude Desktop angezeigt. Sie können jedes Tool einzeln aktivieren oder deaktivieren und so direkt über die Claude-Oberfläche auf Funktionen wie Finanzkontextanalysen, Marktübersichten, Portfoliomanagement und Aktienwarnungen zugreifen.
Unten sehen Sie einen Screenshot, der zeigt, wie die Tools von Ihrem MCP-Server in Claude Desktop aufgelistet und umgeschaltet werden:
- Jedes Tool (z. B.
financial_context , market_summary , add_stock usw.) kann nach Bedarf aktiviert oder deaktiviert werden. - Diese nahtlose Integration ermöglicht Ihnen die Interaktion mit Ihrem Finanzanalyseserver mithilfe natürlicher Sprache und toolbasierter Workflows innerhalb von Claude Desktop.
Anwendungsbeispiele
- Marktübersicht abrufen : Verwenden Sie das Tool
market_summary , um Live-Indizes, Marktteilnehmer und Nachrichten abzurufen. - Portfolio verwalten : Verwenden Sie
add_stock , remove_stock und get_portfolio , um Ihre verfolgten Aktien zu aktualisieren und anzuzeigen. - Benachrichtigungen erhalten : Konfigurieren Sie Schwellenwerte und erhalten Sie Telegrammbenachrichtigungen zu Preisbewegungen und Handelsmöglichkeiten.
- Kontextanalyse : Verwenden Sie
financial_context , um eine Abfrage zu analysieren, Ticker zu extrahieren und zusammengefasste Nachrichten und eine marktbezogene Eingabeaufforderung zu erhalten.
Fehlerbehebung und Protokolle
- Alle Protokolle werden in die Datei
financial_mcp.log im Projektstamm geschrieben. - Überprüfen Sie zum Debuggen die Protokolldatei und stellen Sie sicher, dass Ihre Umgebungsvariablen und Konfigurationsdateien korrekt sind.
- Wenn Sie Probleme mit Telegram oder dem Abrufen von Nachrichten haben, überprüfen Sie Ihre API-Schlüssel und Ihre Internetverbindung.