MCP-Inscription Server

Überblick

Ein Model Context Protocol (MCP)-Server, der es KI-Modellen ermöglicht, mit Ordinals Inscriptions zu interagieren und so Inhalte aus einer Transaktion anzuzeigen.

Related MCP server: MCP Bitcoin CLI

🎮 Demo

💼 Inhaltsverzeichnis

• MCP-Inscription Server

  • Überblick

  • 💼 Inhaltsverzeichnis

  • 🔧 Funktionen

  • 🦆 Goose-Integration

    • Verwenden von STDIO (lokale Erweiterung)

      • Verwenden von SSE (Remote Extension)

  • 🔑 Claude Desktop Integration

    • Testen der Claude Desktop-Integration

  • 📂 Projektstruktur

  • 📦 Entwicklungs-Setup

  • 📦 Verfügbare Tools

    • Ordinalzahlen anzeigen

  • 🚨 Fehlerbehandlung

  • 🤝 Beitragen

  • 📝 Lizenz

🔧 Funktionen

• Ordinalerkennung : Automatische Erkennung und Analyse von Bitcoin-Transaktionen in Ordinalzahlen. Unterstützung von textbasierten Formaten, Bildern, JSON und weiteren Beschriftungsformaten.

🦆 Goose-Integration

Goose ist ein Open-Source-KI-Agenten-Framework von Block, das Erweiterungen über das Model Context Protocol unterstützt. Sie können den MCP-Inscription-Server als Goose-Erweiterung integrieren, um Goose die Interaktion mit Ordinals Inscriptions zu ermöglichen. Goose unterstützt zwei Integrationsmodi für MCP-Server: den Betrieb des Servers als lokaler Prozess (STDIO) oder die Verbindung als Remote-Dienst über Server-Sent Events (SSE). Nachfolgend finden Sie Anweisungen für beide Methoden:

Verwenden von STDIO (lokale Erweiterung)

Diese Methode führt den MCP-Inscription-Server lokal als Unterprozess von Goose aus und kommuniziert über die Standard-Eingabe/Ausgabe.

1. Klonen und erstellen Sie das MCP-Inscription-Repository (falls Sie dies noch nicht getan haben):

   git clone https://github.com/Laz1mov/mcp-inscription
   cd mcp-inscription
   npm install
   npm run build

   Notieren Sie sich den vollständigen absoluten Pfad zum Repository, da Sie ihn im nächsten Schritt benötigen.

2. Fügen Sie eine neue Erweiterung in Goose hinzu: Öffnen Sie die Konfigurationsoberfläche von Goose. Sie können dies über die Kommandozeile tun, indem Sie goose configure “ ausführen, oder in der Goose Desktop-App, indem Sie zu Einstellungen > Erweiterungen gehen. Wählen Sie im Menü „Erweiterung hinzufügen“. ( Verwenden von Erweiterungen | goose )

3. Wählen Sie den Erweiterungstyp – Befehlszeilenerweiterung: Wenn Sie nach dem Erweiterungstyp gefragt werden, wählen Sie „Befehlszeilenerweiterung“ (im CLI-Menü oder in der Benutzeroberfläche), damit Goose weiß, dass es einen lokalen Befehl ( Verwenden von Erweiterungen | goose ) starten soll (und nicht eine integrierte oder Remote-Erweiterung).

4. Geben Sie die Erweiterungsdetails ein: Geben Sie einen Namen und einen Befehl für den MCP-Inscription-Server an:

   • ID : mcp-inscription

   • Name: Sie können es „mcp-inscription“ oder eine beliebige Kennung nennen (so beziehen Sie sich auf die Erweiterung).

   • Befehl: Geben Sie den vollständigen Pfad zum erstellten CLI-Skript an. Beispiel:

     node /absolute/path/to/mcp-inscription/build/cli.js

     Ersetzen Sie /absolute/path/to/mcp-inscription durch den tatsächlichen Pfad, unter dem Sie das Repository geklont haben.

   • Normalerweise müssen Sie über den Skriptpfad hinaus keine Argumente hinzufügen (es sei denn, Ihr Server erfordert spezielle Flags).

5. Abschließen und aktivieren: Schließen Sie das Hinzufügen der Erweiterung ab. Goose fügt die neue Erweiterung seiner Konfiguration hinzu (normalerweise ~/.config/goose/config.yaml ). Stellen Sie sicher, dass die Erweiterung aktiviert ist (bei Verwendung des CLI-Assistenten sollte sie standardmäßig aktiviert sein; in der Goose Desktop-App können Sie die Erweiterungsliste überprüfen und sie aktivieren, falls sie noch nicht aktiviert ist ( Verwenden von Erweiterungen | goose ).

6. Starten Sie eine Goose-Sitzung mit der neuen Erweiterung: Sie können die Erweiterung jetzt in Goose verwenden. Wenn Sie Goose über die Befehlszeilenschnittstelle ausführen, starten Sie eine Sitzung mit der Erweiterung, indem Sie Folgendes ausführen:

   goose session --with-extension "mcp-inscription"

Ersetzen Sie „ordinals“ durch den Namen, den Sie der Erweiterung gegeben haben ( Verwenden von Erweiterungen | goose ). (Dadurch wird sichergestellt, dass die Sitzung die Erweiterung lädt. Alternativ ist die Erweiterung global aktiviert und steht über Goose Desktop oder die CLI automatisch in allen Sitzungen zur Verfügung.)

Verwenden von SSE (Remote Extension)

Diese Methode verbindet Goose über einen HTTP-SSE-Stream mit einem bereits laufenden MCP-Server. Verwenden Sie diese Methode, wenn Sie den MCP-Inscription-Server als eigenständigen Dienst ausführen möchten (möglicherweise auf einem anderen Rechner oder unabhängig von Goose).

1. Starten Sie den MCP-Server als eigenständigen Dienst: Führen Sie den MCP-Inscription-Server im SSE-Modus aus, um auf Verbindungen zu warten:

   # Navigate to your mcp-inscription directory
   cd /path/to/mcp-inscription
   
   # If you havent built it yet
   npm install
   npm run build
   
   # Run in SSE mode on port 3000 (default)
   SERVER_MODE=sse node build/cli.js
   
   # Alternatively, specify a different port
   SERVER_MODE=sse PORT=9000 node build/cli.js

   Dadurch wird der Server im SSE-Modus gestartet und ist unter http://localhost:3000 (oder Ihrem angegebenen Port) verfügbar.

2. Fügen Sie eine neue Erweiterung in Goose (Remote) hinzu: Führen Sie wie zuvor goose configure aus oder verwenden Sie die Goose-Benutzeroberfläche, um eine Erweiterung hinzuzufügen ( Verwenden von Erweiterungen | goose ). Wählen Sie dieses Mal „Remote-Erweiterung“, wenn Sie nach dem Erweiterungstyp gefragt werden ( Verwenden von Erweiterungen | goose ). Dadurch wird Goose informiert, dass es über SSE eine Verbindung zu einem externen Server herstellt.

3. Geben Sie die Details der Remote-Erweiterung ein: Benennen Sie die Erweiterung (z. B. „ordinals“) und geben Sie die URL des Servers an. Geben Sie als URL die Basisadresse des MCP-Servers ein. Wenn Ihr Server beispielsweise Port 9000 auf Ihrem lokalen Rechner nutzt, geben Sie http://localhost:9000 ein. Goose versucht dann, eine Verbindung zum SSE-Endpunkt des MCP-Servers unter dieser Adresse herzustellen. (Goose verwendet den Standard-MCP-SSE-Pfad, der sich üblicherweise unter der Route /mcp/sse auf dem Server befindet. Sie müssen in der Regel nur Host und Port angeben, Goose erledigt den Rest.)

4. Aktivieren Sie die Erweiterung: Stellen Sie nach dem Hinzufügen der Remote-Erweiterung sicher, dass sie in den Goose-Einstellungen aktiviert ist (genau wie im STDIO-Fall). Es muss nur eine der STDIO- oder SSE-Erweiterungen (mit denselben Tools) aktiviert werden. Sollten Sie versehentlich sowohl eine lokale als auch eine Remote-Version desselben Servers aktivieren, deaktivieren Sie am besten eine davon, um Verwirrung zu vermeiden.

Verwendung der MCP-Inscription-Erweiterung in Goose: Sobald die Erweiterung (mit einer der oben genannten Methoden) eingerichtet und aktiviert ist, können Sie mit Goose interagieren und Bestelldaten darüber abfragen. Stellen Sie in einem neuen Goose-Chat oder einer neuen Goose-Sitzung einfach wie gewohnt Fragen. Goose erkennt automatisch, wann die MCP-Inscription-Tools zur Bearbeitung Ihrer Anfrage eingesetzt werden müssen. Beispiel:

• "Zeigen Sie mir die Ordnungszahlen: 0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389?"

Wenn Sie diese Fragen stellen, ruft Goose die Tools des MCP-Inscription-Servers auf und gibt die Antwort zurück (z. B. die neuesten Bitcoin-Blockinformationen). Goose sollte mit aktuellen Informationen aus der Bitcoin-Blockchain über den MCP-Inscription-Server antworten.

Wenn Goose die Erweiterung scheinbar nicht verwendet (z. B. wenn die Meldung angezeigt wird, dass die Informationen nicht gefunden werden können), stellen Sie sicher, dass die Erweiterung aktiviert ist und der Server läuft (im SSE-Modus für Remote-Zugriff). Sie können auch die Goose-CLI mit ausführlicher Protokollierung ausführen, um zu prüfen, ob die Erweiterung aufgerufen wurde. Bei korrekter Konfiguration erkennt Goose die Funktionen des MCP-Inscription-Servers automatisch und nutzt sie gegebenenfalls.

Weitere Ressourcen: Weitere Informationen zu Goose-Erweiterungen und dem MCP finden Sie in der offiziellen Goose-Dokumentation ( Verwendung von Erweiterungen | goose ). Die Dokumentation enthält eine Liste der integrierten und Community-Erweiterungen und erklärt, wie sich MCP-Server in Goose integrieren. Ein Verzeichnis der verfügbaren MCP-Server sowie zusätzliche Konfigurationstipps finden Sie ebenfalls in der Goose-Dokumentation und der Dokumentation zum Model Context Protocol. Dies kann hilfreich sein, wenn Sie weitere Erweiterungen erkunden oder eigene entwickeln möchten.

🔑 Claude Desktop Integration

Um den MCP-Inscription-Server mit Claude Desktop (Anthropics Desktop-App für Claude) zu verwenden, folgen Sie diesen Schritten:

1. Claude Desktop herunterladen und installieren: Besuchen Sie die offizielle Downloadseite von Claude Desktop und laden Sie die App für Ihr Betriebssystem (macOS oder Windows) herunter ( Installation von Claude für Desktop | Anthropic Help Center ). Installieren Sie die App und stellen Sie sicher, dass Sie die neueste Version verwenden (Updates finden Sie im App-Menü).

2. Klonen und Erstellen des MCP-Inscription-Repository:

   git clone https://github.com/Laz1mov/mcp-inscription
   cd mcp-inscription
   npm install
   npm run build

3. Konfigurieren Sie Claude Desktop für die Verwendung des MCP-Inscription-Servers: Öffnen Sie die Konfigurationsdatei von Claude Desktop (sie wird erstellt, wenn Sie die Einstellungen in Claude Desktop zum ersten Mal bearbeiten):

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
     Fügen Sie in dieser JSON-Konfiguration im Abschnitt "mcpServers" einen Eintrag für den MCP-Inscription-Server hinzu. Beispiel:

   {
     "mcpServers": {
       "mcp-inscription": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-inscription/build/cli.js"]
       }
     }
   }

   Im obigen Snippet ist "mcp-inscription" eine Kennung für den Server (Sie können ihn beliebig benennen). Ersetzen Sie /absolute/path/to/mcp-inscription durch den vollständigen Pfad zum geklonten Repository.

4. Starten Sie Claude Desktop neu: Speichern Sie die Datei claude_desktop_config.json , schließen Sie Claude Desktop und öffnen Sie es erneut. Beim nächsten Start startet Claude den MCP-Inscription-Server automatisch wie konfiguriert. Falls Claude Desktop bereits ausgeführt wurde, müssen Sie es neu starten, damit die Änderungen wirksam werden.

Testen der Claude Desktop-Integration

Sobald Claude Desktop neu gestartet ist, können Sie testen, ob der MCP-Inscription-Server ordnungsgemäß funktioniert:

• Überprüfen Sie die Antwort: Claude sollte eine detaillierte Antwort (z. B. die Inschrift selbst oder Runeninformationen) ohne Fehler zurückgeben. Wenn Sie eine Fehlermeldung oder keine nützliche Antwort erhalten, ist der MCP-Server möglicherweise nicht richtig verbunden.

• Überprüfen Sie Claudes Protokolle (falls erforderlich): Claude Desktop stellt Protokolldateien bereit, die beim Debuggen von MCP-Integrationen helfen können. Falls das Tool nicht reagiert, überprüfen Sie die Protokolldateien in:

  • macOS: ~/Library/Logs/Claude/

  • Windows: %APPDATA%\Claude\logs\
    Suchen Sie in mcp.log nach allgemeinen MCP-Verbindungsmeldungen und in der Datei mcp-server-mcp-inscription.log (oder einem anderen von Ihnen gewählten Namen) nach den Ausgaben/Fehlern des MCP-Servers. Diese Protokolle zeigen an, ob der Server gestartet wurde oder ob Fehler aufgetreten sind (z. B. ein falscher Pfad oder Ausnahmen im Server). Sollten Fehler auftreten, korrigieren Sie die Konfiguration oder Umgebung entsprechend, starten Sie Claude Desktop neu und testen Sie es erneut.

Installation über Smithery

So installieren Sie Inscription Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @Laz1mov/mcp-inscription --client claude

📂 Projektstruktur

mcp-inscription/
├── src/
│   ├── ordinals_client.ts      # Bitcoin ordinals and runestone utility functions
│   ├── servers/
│   │   ├── index.ts            # Server exports and factory functions
│   │   ├── sse.ts              # Server implementation using SSE transport
│   │   ├── stdio.ts            # Server implementation using STDIO transport
│   │   └── base.ts             # Base server implementation with shared functionality
│   ├── index.ts                # Main entry point
│   ├── cli.ts                  # CLI launcher
│   ├── mcp_inscription_types.ts # Shared types and schemas for the MCP-Inscription server
│   └── utils/
│       ├── logger.ts           # Logger setup
│       ├── cache.ts            # Caching implementation
│       ├── error_handlers.ts   # Error handling utilities
│       ├── json_utils.ts       # JSON processing utilities
│       ├── img_utils.ts        # Image processing and conversion utilities
│       └── version.ts          # Version information
├── .env.example                # Example environment configuration file
├── package.json
├── tsconfig.json
└── README.md

📦 Verfügbare Tools

Ordinalzahlen anzeigen

Beschreibung:
Dekodiert ordinale Inschriftdaten aus den Zeugendaten einer Transaktion.

Eingabeschema:

{
  "txid": "string"
}

Beispieleingabe:

{
  "txid": "0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389"
}

Ausgabe:
Gibt den dekodierten Beschriftungsinhalt zurück, der im Text-, JSON-, HTML- oder anderen Formaten vorliegen kann.

🚨 Fehlerbehandlung

Der Server verwendet benutzerdefinierte Fehlertypen zur Verarbeitung von Bitcoin-Operationen und Blockchain-Abfragen. Detaillierte Fehlermeldungen werden mit Pino protokolliert und in die Client-Antworten integriert, um die Fehlersuche zu vereinfachen.

🤝 Beitragen

Beiträge und Funktionsanfragen sind willkommen! Sie können gerne Pull Requests oder offene Probleme auf GitHub einreichen.

📝 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.