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

Klonen Sie das Repository:

git clone https://github.com/your-org/cw-social-mcp.git
cd cw-social-mcp

Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie das Projekt:

npm run build

Konfigurieren Sie Umgebungsvariablen (siehe Abschnitt „Konfiguration“)

Konfiguration

MCP-Server-Setup

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

{
  "mcpServers": {
    "cw-graph": {
      "command": "node",
      "args": ["PATH_TO_YOUR_PROJECT/dist/index.js"],
      "env": {
        "NODE_URL": "http://localhost:26657",
        "WALLET_MNEMONIC": "your wallet mnemonic phrase",
        "CONTRACT_ADDRESS": "your contract address",
        "DENOM": "stake",
        "BENCH32_PREFIX": "cyber"
      }
    }
  }
}

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

# Production build
npm run build

# Development mode
npm run dev

Projektstruktur

src/
├── index.ts                # Entry point
├── cyberlink-service.ts    # Core service
├── services/
│   ├── embedding.service.ts  # Semantic analysis
│   └── __tests__/           # Test suite
└── types.ts                # Type definitions

cursor_rules/
└── chat_history.mdc       # Chat rules

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.

docker run \
  --name cw-social \
  -v $(pwd)/hf-cache:/app/hf-cache \
  --env-file .env \
  -p 8000:8000 \
  cw-social-mcp

-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

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

Lizenz

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

Cyberlink MCP Server

Integrations