Inhaltsverzeichnis
1. Einleitung
SSI Stock Data MCP ist ein Model Context Protocol (MCP)-Server zum Abrufen von Intraday-Daten zu vietnamesischen Aktien. Er ermöglicht KI-Assistenten und Tools die programmgesteuerte und sichere Abfrage von Intraday-Daten über die SSI FastConnect API .
2. Funktionen
- [x] Liste der Aktiencodes nach Börse
- [x] Detaillierte Informationen zu einem Lagercode abrufen
- [x] Rufen Sie die Liste der Aktiencodes in einem Indexkorb ab
- [x] Rufen Sie die Liste der Indexcodes ab
- [x] Rufen Sie die Eröffnungs-, Höchst-, Tiefst-, Schluss-, Volumen- und Wertinformationen eines Aktiencodes anhand der einzelnen Tickdaten ab
- [x] Rufen Sie die Eröffnungs-, Höchst-, Tiefst-, Schluss-, Volumen- und Wertinformationen eines Aktiencodes nach Tag ab
- [x] Abrufen der täglichen Handelsergebnisse des zusammengesetzten Index
- [x] Abrufen der täglichen Handelsinformationen eines Aktiencodes
- [x] Unterstützung für Docker-Containerisierung
- [ ] Unterstützung beim Abrufen von Echtzeitdaten über Streaming-Adapter (in Planung)
- [ ] Unterstützung der Auftragsverwaltung und des Handels über MCP (zukünftige Überlegung)
3. Schnellstart
3.1. Voraussetzungen
- Python 3.12+
- uv (für schnelles Abhängigkeitsmanagement).
- Docker (optional, für die Bereitstellung in Containern).
- Stellen Sie sicher, dass Sie sich für den SSI FastConnect-Dienst registrieren, bevor Sie diesen MCP-Server ausführen. Sie können sich bei SSI FastConnect registrieren, um Ihre Consumer-ID und Ihr Geheimnis zu erhalten.
Installation über Smithery
So installieren Sie den SSI Stock MCP Server für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude
3.2. Lokaler Lauf
- Klonen Sie das Repository:
# Clone the repository
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
- Konfigurieren der Umgebungsvariablen
# Set environment variables (see .env.sample)
FC_DATA_URL=https://fc-data.ssi.com.vn/ #optional
FC_DATA_AUTH_TYPE=Bearer #optional
FC_DATA_CONSUMER_ID=your_consumer_id
FC_DATA_CONSUMER_SECRET=your_consumer_secret
- Fügen Sie die Serverkonfiguration zu Ihrer Client-Konfigurationsdatei hinzu. Beispiel für Claude Desktop:
{
"mcpServers": {
"SSIStockMCPServer": {
"command": "uv",
"args": ["--directory", "full-path", "run", "ssi-stock-mcp-server"],
"env": {
"FC_DATA_CONSUMER_ID": "id",
"FC_DATA_CONSUMER_SECRET": "id",
"FC_DATA_URL": "https://fc-data.ssi.com.vn/",
"FC_DATA_AUTH_TYPE": "Bearer"
}
}
}
}
- Starten Sie Claude Desktop neu, um die neue Konfiguration zu laden.
- Sie können Claude jetzt bitten, in natürlicher Sprache mit Daten zu interagieren:
- „Dieser VN30 ist ein echter Hingucker“
- „Get volume room ngoại đã bán của SSI hom noy“
- „So sánh vol của SSI với VND trong ngày hôm noy“
- „Gesamtspielvolumen mit SSI über 1 Stunde“
3.3. Docker-Ausführung
- Führen Sie es mit einem vorgefertigten Image aus (oder Sie können es selbst erstellen):
$ docker run -p 8000:8000
-e FC_DATA_CONSUMER_ID=id
-e FC_DATA_CONSUMER_SECRET=id ghcr.io/archiephan78/ssi-stock-mcp-server
- Ausführen mit Docker in Claude Desktop:
{
"mcpServers": {
"SSIStockMCPServer": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "FC_DATA_CONSUMER_ID",
"-e", "FC_DATA_CONSUMER_SECRET",
"ghcr.io/archiephan78/ssi-stock-mcp-server:latest"
],
"env": {
"FC_DATA_CONSUMER_ID": "your_username",
"FC_DATA_CONSUMER_SECRET": "your_password"
}
}
}
}
Diese Konfiguration übergibt die Umgebungsvariablen von Claude Desktop an den Docker-Container, indem sie das Flag -e nur mit dem Variablennamen verwendet und die tatsächlichen Werte im env bereitstellt.
4. Werkzeuge
Der MCP-Server stellt Tools bereit:
- Wertpapierliste abrufen:
get_securities_list() - Wertpapierdetails abrufen:
get_securities_details() - Index abrufen:
get_index_components() - Listenindex abrufen:
get_index_list() - Tägliche Eröffnung, Höchstwert, Tiefstwert und Schlusswert ermitteln:
get_daily_ohlc() - Intraday-Eröffnung, -Hoch, -Tief und -Schluss abrufen:
get_intraday_ohlc() - Täglichen Index abrufen:
get_daily_index() - Aktienkurs abrufen:
get_stock_price()
Vollständige API-Details finden Sie unter src/ssi_stock_mcp_server/server.py .
5. Entwicklung
Beiträge sind willkommen! Bitte melden Sie ein Problem oder senden Sie einen Pull Request, wenn Sie Vorschläge oder Verbesserungen haben.
Dieses Projekt verwendet UV zur Verwaltung von Abhängigkeiten. Installieren Sie UV gemäß den Anweisungen für Ihre Plattform.
# Clone the repository
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
$ uv venv
$ source .venv/bin/activate # On Unix/macOS
$ .venv\Scripts\activate # On Windows
$ uv pip install -e .
# run test
$ pytest
6. Lizenz
Apache 2.0
Kontakt / Support
- Bitte öffnen Sie ein Problem auf GitHub, wenn Sie auf Probleme stoßen oder Unterstützung benötigen.
- E-Mail: n/a