Chronos MCP Server

Chronos MCP Server 🔵

Chronos ist ein auf die Stellar-Blockchain zugeschnittener Model Context Protocol (MCP)-Server, der speziell für die Integration mit Claude Desktop und ähnlichen KI-Anwendungen entwickelt wurde. Chronos stattet Ihren KI-Assistenten mit On-Chain-Tools aus, die eine optimierte Interaktion mit dem Stellar-Netzwerk ermöglichen.

Überblick

Chronos MCP bietet die folgenden Funktionen:

Mit Stellar Wallets verbinden: Stellen Sie mithilfe eines geheimen Schlüssels eine sichere Verbindung zu Ihrem Wallet her.
Wallet-Token auflisten: Alle in einem Stellar-Wallet gespeicherten Token abrufen und auflisten.
Salden abfragen: Erhalten Sie Echtzeitsalden für Ihr XLM und andere Vermögenswerte.
Geld überweisen: Leiten Sie problemlos Überweisungen zwischen Stellar-Wallets ein.

Chronos ist erweiterbar und funktioniert als Standard-Node.js-Paket, sodass es einfach bereitgestellt, installiert und integriert werden kann – ähnlich wie andere MCP-Server wie Base-MCP.

Merkmale

Stellar-Integration: Vollständige Interaktion mit dem Stellar-Mainnet über die Horizon-API.
Einfache Bereitstellung: Veröffentlichen und installieren Sie Chronos mit npm.
Kompatibilität mit Claude Desktop: Nahtlose Integration mit Claude Desktop durch Aktualisierung der MCP-Serverkonfiguration.
Erweiterbare Architektur: Entwickelt für zukünftige Erweiterungen und die Integration neuer Tools.

Voraussetzungen

Node.js (v14 oder höher)
npm
Stellar Wallet-Anmeldeinformationen (geheimer Schlüssel für die Verbindung)
Internetverbindung zur Interaktion mit dem Stellar-Netzwerk

Installation

Option 1: Von npm installieren (empfohlen)

Installieren Sie Chronos global:

npm install -g chronos-mcp

Oder verwenden Sie es direkt mit npx:

npx chronos-mcp@latest

Option 2: Von der Quelle installieren

Klonen Sie das Repository:
git clone https://github.com/yourusername/chronos-mcp.git cd chronos-mcp
Installieren Sie Abhängigkeiten:
npm install
Erstellen Sie das Projekt:
npm run build
(Optional) Globaler Link für einfacheren Zugriff:
npm link

Option 3: Verwenden von Docker

Sie können Chronos MCP auch mit Docker ausführen:

Erstellen Sie das Docker-Image:
docker build -t chronos-mcp .
Führen Sie den Container aus:
docker run -it --rm chronos-mcp

Ausführlichere Anweisungen zur Verwendung von Docker mit Chronos MCP, einschließlich der Einrichtung von Docker Compose und der Integration mit Claude Desktop, finden Sie im Docker-Nutzungshandbuch .

Um zu testen, ob Ihr Docker-Setup lokal funktioniert, folgen Sie den Schritt-für-Schritt-Anweisungen im Docker-Testhandbuch . Dieses Handbuch enthält Anweisungen zum Erstellen des Docker-Images, zum Ausführen des Containers und zum Testen seiner Funktionalität.

Konfiguration

Umgebungsvariablen

Chronos MCP verwendet Umgebungsvariablen zur Konfiguration, insbesondere für sensible Informationen wie Ihren Stellar-Geheimschlüssel. Das Projekt verwendet dotenv , um während der Entwicklung Umgebungsvariablen aus einer .env Datei zu laden.

So konfigurieren Sie Umgebungsvariablen:

Erstellen Sie eine .env Datei im Projektstammverzeichnis:
STELLAR_SECRET_KEY=your_stellar_secret_key STELLAR_NETWORK=mainnet
Diese Variablen werden beim Start der Anwendung automatisch geladen.

Wenn Sie Docker verwenden, können Sie Umgebungsvariablen auf verschiedene Arten bereitstellen:

Verwenden des Flags --env-file : docker run -it --rm --env-file .env chronos-mcp
Verwenden der env_file -Direktive in docker-compose.yml
Festlegen einzelner Variablen mit dem Flag -e : docker run -it --rm -e STELLAR_SECRET_KEY=your_key chronos-mcp

Claude Desktop-Konfiguration

Um Chronos mit Claude Desktop zu verwenden, aktualisieren Sie Ihre Claude Desktop-Konfigurationsdatei unter:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Beispielkonfiguration für Claude Desktop:

{
<<<<<<< HEAD
  "mcpServers": {
    "stellar": {
      "command": "npx",
      "args": ["chronos-mcp@latest"],
      "env": {
        "STELLAR_NETWORK": "mainnet",
        "STELLAR_SECRET_KEY": "your_stellar_secret_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Für die Docker-Integration mit Claude Desktop können Sie Folgendes verwenden:

{
  "mcpServers": {
    "stellar": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file", "/path/to/your/.env", "chronos-mcp"],
      "env": {
        "STELLAR_NETWORK": "mainnet"
      },
      "disabled": false,
      "autoApprove": []
=======
    "mcpServers": {
        "stellar": {
            "command": "npx",
            "args": [
                "chronos-mcp@latest"
            ],
            "env": {
                "STELLAR_NETWORK": "mainnet",
                "STELLAR_SECRET_KEY": "XXXX"
            },
            "disabled": false,
            "autoApprove": []
        }
>>>>>>> b2501026b3b5ef4c512fceaf340f53b5102a57f9
    }
}

Verwendung

Chronos MCP stellt über seine MCP-Schnittstelle die folgenden Tools bereit:

connect_wallet

Stellt mithilfe des geheimen Schlüssels eine Verbindung zu einer Stellar-Wallet her.

Beispielbefehl:

„Verbinde mein Wallet mit dem geheimen Schlüssel ______“

Tokenliste

Listet alle Token und Vermögenswerte in der angegebenen Stellar-Wallet auf.

Beispielbefehl:

„Liste meine Wallet-Token auf“

get_balances

Ruft den Kontostand für XLM und alle anderen Vermögenswerte ab.

Beispielbefehl:

„Wie hoch ist mein aktuelles XLM-Guthaben?“

Geld überweisen

Überweist Geld von Ihrem Wallet auf ein anderes Stellar-Wallet.

Parameter:

secretKey : Der geheime Schlüssel Ihres Wallets.
destinationAddress : Die Wallet-Adresse des Empfängers.
amount : Der zu überweisende Betrag.
asset(optional) : Zu übertragendes Asset (standardmäßig XLM).

Beispielbefehl:

„Überweisen Sie 0,5 XLM an [Ziel-Wallet-Adresse]“

Testen

Standardtests

So testen Sie Chronos MCP lokal:

npm test

Dadurch wird die Testsuite des Projekts ausgeführt und überprüft, ob Ihr Server wie erwartet funktioniert.

Docker-Tests

Um das Docker-Setup lokal zu testen, finden Sie detaillierte Anweisungen im Docker-Testhandbuch . Das Handbuch behandelt:

Erstellen des Docker-Images
Ausführen des Containers mit Docker Compose
Testen der Containerfunktionalität
Beheben häufiger Probleme

Sie können auch das enthaltene Skript test-client.js verwenden, um den Docker-Container zu testen:

node test-client.js

Dieses Skript sendet eine einfache MCP-Anfrage an den Docker-Container und zeigt die Antwort an.

Einsatz

Chronos MCP ist als Standard-Node.js-Paket konzipiert und kann auf npm veröffentlicht werden. Nach der Veröffentlichung (z. B. über npm publish ) kann Chronos global installiert oder wie jeder andere MCP-Server über npx verwendet werden.

Erwägen Sie für die Produktionsbereitstellung, Chronos in einen Systemdienst einzubinden (mit systemd, launchd usw.), um automatische Neustarts und Überwachung zu ermöglichen.

Erweiterung von Chronos

Chronos ist auf Erweiterbarkeit ausgelegt. So fügen Sie neue Tools hinzu:

Erstellen Sie ein neues Verzeichnis im Ordner src/tools .
Implementieren Sie Ihr Tool (fügen Sie index.ts , schemas.ts und handlers.ts ein).
Exportieren Sie Ihr Tool in src/tools/index.ts .
Aktualisieren Sie die README-Datei mit der Dokumentation und Beispielen Ihres Tools.
Schreiben Sie Tests, um sicherzustellen, dass Ihr neues Tool ordnungsgemäß funktioniert.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Beitragen

Beiträge sind willkommen! Bitte konsultieren Sie CONTRIBUTING.md für Richtlinien zum Melden von Problemen, Einreichen von Pull Requests und weitere Anweisungen zum Beitragen.

────────────────────────────── Diese README-Datei ist speziell auf Chronos MCP zugeschnitten und beschreibt die Bereitstellung als Node.js-Paket, die Integration mit Claude Desktop und einen umfassenden Satz von Funktionen zur Interaktion mit der Stellar-Blockchain.

Chronos MCP Server

Integrations