Monad MCP Server

Monad MCP Server

Dieser MCP-Server (Model Context Protocol) ist für die Interaktion mit dem Monad-Testnetz konzipiert. Er bietet Entwicklern eine Reihe von Tools und Funktionen für die Monad-Blockchain, darunter die Überprüfung von MON-Token-Guthaben, das Senden von Transaktionen, die Bereitstellung von Smart Contracts und die Überwachung von Blockchain-Ereignissen.

Was ist MCP?

Das Model Context Protocol (MCP) ist eine standardisierte Schnittstelle, die KI-Modellen die sichere und effektive Interaktion mit externen Tools, Diensten und Datenquellen ermöglicht. Dieser Server implementiert MCP, um Monad-Blockchain-Funktionen kompatiblen KI-Agenten oder -Anwendungen zugänglich zu machen.

Projektstruktur

Das Projekt ist wie folgt organisiert:

Schlüsselkomponenten

• src/index.ts : Dies ist der Haupteinstiegspunkt für den Server. Es initialisiert die MCP-Serverinstanz und registriert alle verfügbaren Tools (Wallet, Vertrag, NFT, Block).
• src/config/server.ts : Diese Datei verwaltet die Serverkonfiguration. Sie richtet die McpServer -Instanz mit Name, Version und einer Liste von Funktionen ein. Sie initialisiert außerdem den öffentlichen Viem -Client für die Interaktion mit dem Monad-Testnetz und bietet eine Funktion zum Erstellen eines Viem -Wallet-Clients mithilfe eines privaten Schlüssels aus Umgebungsvariablen. Der Server nutzt StdioServerTransport zur Kommunikation.
• src/tools/ : Dieses Verzeichnis enthält die Implementierungen verschiedener MCP-Tools. Jedes Unterverzeichnis konzentriert sich typischerweise auf einen bestimmten Aspekt der Monad-Interaktion:
  • walletProvider : Verwaltet MON-Token-Guthaben und -Transaktionen.
  • contractProvider : Behandelt die Bereitstellung von Smart Contracts und die Ereignisüberwachung.
  • nftProvider : Bietet Funktionen zum Abfragen von NFTs im Monad-Netzwerk.
  • blockProvider : Bietet Tools zum Abrufen von Blockinformationen.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Folgendes installiert ist:

• Node.js (Version 16 oder höher)
• Ein Node.js-Paketmanager: npm , yarn oder pnpm (dieses Projekt verwendet pnpm in seinen Beispielen)
• Claude Desktop (oder ein beliebiger MCP-kompatibler Client) zur Interaktion mit dem Server.

Umgebungsvariablen (.env)

Dieses Projekt verwendet Umgebungsvariablen zur Verwaltung vertraulicher Informationen, vor allem des privaten Schlüssels Ihres Monad-Kontos.

1. Kopieren Sie die Beispieldatei : Erstellen Sie eine Kopie von .env.example und benennen Sie sie in .env um.
   cp .env.example .env
2. .env bearbeiten : Öffnen Sie die neu erstellte .env Datei in einem Texteditor.
3. PRIVATE_KEY setzen : Füllen Sie die Variable PRIVATE_KEY mit dem privaten Schlüssel Ihres Monad-Kontos aus. Dieser Schlüssel ist für Vorgänge wie das Senden von Transaktionen oder das Bereitstellen von Verträgen erforderlich.
   PRIVATE_KEY="0xyourprivatekeyhere"
   Wichtig : Stellen Sie sicher, dass Ihr privater Schlüssel mit 0x beginnt.
4. Sicherheit : Übertragen Sie Ihre .env Datei niemals in ein Git-Repository. Die .gitignore Datei ist bereits so konfiguriert, dass dies verhindert wird. Achten Sie jedoch stets auf den Schutz Ihrer privaten Schlüssel.

Erste Schritte

Befolgen Sie diese Schritte, um den Monad MCP-Server einzurichten und auszuführen:

1. Klonen Sie das Repository :Falls Sie dies noch nicht getan haben, klonen Sie das Projekt von GitHub:
   git clone https://github.com/lispking/monad-mcp-server.git cd monad-mcp-server
2. Abhängigkeiten installieren :Verwenden Sie pnpm (oder Ihren bevorzugten Paketmanager), um die in package.json aufgeführten Projektabhängigkeiten zu installieren:
   pnpm install
3. Erstellen Sie das Projekt :Der Server ist in TypeScript geschrieben und muss in JavaScript kompiliert werden. Führen Sie das Build-Skript aus:
   pnpm build
   Dieser Befehl verwendet tsc (den TypeScript-Compiler), wie in package.json definiert, um die Quelldateien aus dem src Verzeichnis in das build Verzeichnis zu kompilieren.

Der Server ist jetzt erstellt und kann von einem MCP-Client verwendet werden.

Serverfunktionen

Wie in src/config/server.ts definiert, stellt der Server die folgenden Funktionen bereit:

• get-mon-balance : Ruft den MON-Token-Saldo für ein Konto ab.
• send-mon-transaction : Senden Sie MON-Token von einem Konto zu einem anderen.
• deploy-mon-contract : Stellen Sie einen Smart Contract im Monad-Testnetz bereit.
• watch-contract-events : Überwachen und melden Sie Ereignisse, die von einem bestimmten Smart Contract ausgegeben werden.
• query-mon-nft : Abfrageinformationen zu nicht fungiblen Token im Monad-Netzwerk.
• get-latest-block : Ruft Details zum aktuellsten Block im Monad-Testnetz ab.
• get-block-by-number : Ruft einen bestimmten Block anhand seiner Blocknummer ab.

Hinzufügen der MCP-Serverkonfiguration zu Ihrem Client

Um diesen Server mit einem MCP-kompatiblen Client (wie Claude Desktop) zu verwenden, müssen Sie dessen Konfiguration zu den Client-Einstellungen hinzufügen. Die genaue Vorgehensweise kann je nach Client variieren, erfordert aber in der Regel die Angabe, wie der Server ausgeführt werden soll.

Hier ist ein Beispiel für einen Konfigurationsausschnitt:

Erklärung der Konfigurationsfelder :

• "monad-mcp" : Ein eindeutiger Name, den Sie dieser Serverkonfiguration in Ihrem Client zuweisen.
• "command": "node" : Gibt an, dass der Server eine Node.js-Anwendung ist.
• "args" : Ein Array von Argumenten, die an den node übergeben werden sollen.
  • Das erste Argument ist der Pfad zum kompilierten Einstiegspunkt des Servers: /absolute/path/to/your/project/monad-mcp-server/build/index.js . Ersetzen Sie /absolute/path/to/your/project/ durch den tatsächlichen absoluten Pfad zum geklonten monad-mcp-server Repository.
• "env" : Ein Objekt zum Festlegen von Umgebungsvariablen für den Serverprozess.
  • "PRIVATE_KEY" : Hier können Sie Ihren privaten Schlüssel festlegen. Es wird jedoch generell empfohlen, die .env Datei für mehr Sicherheit zu verwenden. Wenn Sie hier einen Wert festlegen, kann dieser den Wert in .env überschreiben, abhängig vom Verhalten des Clients und der Ladereihenfolge der Umgebungsvariablen des Servers.

Hinweis : Stellen Sie sicher, dass der Pfad in "args" korrekt ist und auf die Datei build/index.js in Ihrem Projektverzeichnis verweist.

Weitere Ressourcen

Ausführlichere Informationen zu den verwendeten Technologien und Konzepten finden Sie in der folgenden offiziellen Dokumentation:

• Dokumentation zum Model Context Protocol (MCP)
• Monad-Dokumentation
• Viem-Dokumentation (Viem ist die in diesem Projekt verwendete Ethereum/Monad-Clientbibliothek)

Diese umfassende README-Datei soll ein solides Verständnis des Monad MCP-Servers, seiner Einrichtung und Verwendung vermitteln.