Cyberlink MCP Server

Cyberlink MCP Server

Ein Model Context Protocol (MCP)-Server für die Interaktion mit dem CW-Social Smart Contract auf Cosmos-basierten Blockchains. Dieser Server bietet eine standardisierte Schnittstelle zum Erstellen, Aktualisieren und Abfragen von Cyberlinks – semantischen Beziehungen zwischen Entitäten in der Blockchain.

Merkmale

• Kernoperationen
  • Erstellen, Lesen, Aktualisieren und Löschen von Cyberlinks
  • Unterstützung für benannte Cyberlinks mit benutzerdefinierten Kennungen
  • Stapelverarbeitung für effiziente Verarbeitung
  • Umfangreiche Abfragefunktionen mit Filterung und Paginierung
• Transaktionsmanagement
  • Echtzeit-Transaktionsüberwachung und Statusabfrage
  • Detaillierte Transaktionsergebnisse und Fehlerbehandlung
  • Unterstützung für die interne und externe Transaktionssignatur
  • Token-Übertragungsfunktionen
• Erweiterte Funktionen
  • Generierung semantischer Einbettungen über Hugging Face-Transformatoren
  • Echtzeit-Fortschrittsverfolgung für Modelloperationen
  • Kosinus-Ähnlichkeitsberechnungen für semantisches Matching
  • Flexibles ID-System mit formatierten IDs (fids) und globalen IDs (gids)
  • Zeitbereichsbasierte Abfragen mit UTC-Unterstützung
  • Eigentümerbasierte Filterung und Statistiken

Voraussetzungen

• Node.js 16 oder höher
• npm oder yarn Paketmanager
• Zugriff auf einen laufenden Cosmos-Blockchain-Knoten
• Wallet mit ausreichend Guthaben für Transaktionen
• Cursor-IDE für die Entwicklung
• Claude Desktop für KI-Unterstützung

Installation

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

3. Erstellen Sie das Projekt:

4. Konfigurieren Sie Umgebungsvariablen (siehe Abschnitt „Konfiguration“)

Konfiguration

MCP-Server-Setup

Erstellen oder ändern Sie die Konfigurationsdatei unter ~/.cursor/mcp.json :

Erforderliche Konfiguration

Erforderliche Umgebungsvariablen:

• PATH_TO_YOUR_PROJECT : Absoluter Pfad zum Projektverzeichnis
• NODE_URL : Cosmos-Blockchain-Knoten-URL
• CONTRACT_ADDRESS : Eingesetzte Smart-Contract-Adresse

Optionale Konfiguration

Optionale Umgebungsvariablen:

• WALLET_MNEMONIC : Wallet-Mnemonik zum Signieren (Standard: keine – Transaktionen werden nicht signiert)
• DENOM : Token-Nennwert (Standard: „Einsatz“)
• BENCH32_PREFIX : BECH32-Präfix

Verfügbare Tools

Cyberlink-Verwaltung

Erstellungstools

Cyberlink erstellen

• Beschreibung: Einzelnen Cyberlink erstellen
• Erforderlich: type
• Optional: from , to , value

create_cyberlink2

• Beschreibung: Knoten + Link erstellen
• Erforderlich: node_type , link_type
• Optional: node_value , link_value , link_to_existing_id , link_from_existing_id

Erstellen Sie einen benannten Cyberlink

• Beschreibung: Benannten Cyberlink erstellen (nur Administrator)
• Erforderlich: name , cyberlink

Cyberlinks erstellen

• Beschreibung: Cyberlinks im Batch erstellen
• Erforderlich: cyberlinks[]

Änderungswerkzeuge

update_cyberlink

• Beschreibung: Vorhandenen Cyberlink aktualisieren
• Erforderlich: gid , cyberlink

Cyberlink löschen

• Beschreibung: Cyberlink entfernen
• Erforderlich: gid

Update mit Einbettung

• Beschreibung: Semantische Einbettung hinzufügen
• Erforderlich: formatted_id

Abfragevorgänge

Grundlegende Abfragen

Abfrage nach GID

• Beschreibung: Abrufen nach globaler ID
• Erforderlich: gid

query_by_fid

• Beschreibung: Abrufen nach formatierter ID
• Erforderlich: fid

query_cyberlinks

• Beschreibung: Alles auflisten mit Seitennummerierung
• Parameter: limit , start_after

Abfrage mit dem Namen Cyberlinks

• Beschreibung: Liste benannter Cyberlinks
• Parameter: limit , start_after

Abfrage nach GIDs

• Beschreibung: Mehrere IDs abrufen
• Erforderlich: gids[]

Gefilterte Abfragen

Abfrage_Cyberlinks_nach_Typ

• Beschreibung: Filtern nach Typ
• Erforderlich: type

query_cyberlinks_by_from

• Beschreibung: Filtern nach Quelle
• Erforderlich: from

query_cyberlinks_by_to

• Beschreibung: Filtern nach Ziel
• Erforderlich: to

Abfrage_Cyberlinks_nach_Eigentümer_und_Typ

• Beschreibung: Filtern nach Besitzer & Typ
• Erforderlich: owner , type

Zeitbasierte Abfragen

query_cyberlinks_by_owner_time

• Beschreibung: Filtern nach Erstellungszeit
• Erforderlich: owner , start_time

query_cyberlinks_by_owner_time_any

• Beschreibung: Filtern nach beliebiger Zeit
• Erforderlich: owner , start_time

Systembetrieb

Vertragsinformationen

query_last_id

• Beschreibung: Zuletzt zugewiesene ID abrufen

Abfragekonfiguration

• Beschreibung: Vertragskonfiguration abrufen

query_debug_state

• Beschreibung: Debug-Status abrufen (nur Administrator)

get_graph_stats

• Beschreibung: Graphstatistiken abrufen

Transaktion & Wallet

Abfragetransaktion

• Beschreibung: TX-Status abrufen
• Erforderlich: transaction_hash

get_tx_status

• Beschreibung: Detaillierten TX-Status abrufen
• Erforderlich: transaction_hash

Abfrage-Wallet-Guthaben

• Beschreibung: Wallet-Guthaben abrufen

send_tokens

• Beschreibung: Transfertoken
• Erforderlich: recipient , amount

Abfrageparameter

Zeitbereichsformat

• Alle Zeitstempel müssen im ISO 8601-Format vorliegen
• Beispiel: 2024-06-01T12:00:00Z
• Wenn keine Zeitzone angegeben ist, wird UTC angenommen.
• start_time ist erforderlich, end_time ist optional

Pagination

• start_after : Paginierungscursor
• limit : Ergebnisse pro Seite (Standard: 50)

Entwicklung

Build-Befehle

Projektstruktur

Fehlercodes

Ungültige Parameter

• Beschreibung: Ungültige Parameter
• Häufige Ursachen: Fehlende Pflichtfelder, falsches Format

MethodeNichtGefunden

• Beschreibung: Unbekanntes Werkzeug
• Häufige Ursachen: Tippfehler im Toolnamen, veraltetes Tool

Interner Fehler

• Beschreibung: Systemfehler
• Häufige Ursachen: Netzwerkprobleme, Vertragsfehler

Führen Sie MCP über SSE aus

Sie können den MCP-Server mit Docker ausführen, um ihn in einen SSE-Server umzuwandeln. Dadurch wird sichergestellt, dass der Hugging Face-Modellcache zwischen den Ausführungen erhalten bleibt und Umgebungsvariablen aus Ihrer .env-Datei geladen werden.

• -v $(pwd)/hf-cache:/app/hf-cache mountet ein lokales Verzeichnis für das Modell-Caching, sodass Modelle nicht jedes Mal erneut heruntergeladen werden.
• --env-file .env lädt Umgebungsvariablen aus Ihrer .env Datei.
• -p 8000:8000 stellt den Server auf Port 8000 bereit.
• --name cw-social benennt Ihren Container zur einfacheren Verwaltung.

Beitragen

1. Forken Sie das Repository
2. Erstellen Sie einen Feature-Zweig ( git checkout -b feature/amazing-feature )
3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add amazing feature' )
4. Pushen zum Zweig ( git push origin feature/amazing-feature )
5. Öffnen einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .