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

Related MCP server: Contextual MCP Server

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:

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

2. Installieren Sie Abhängigkeiten:

npm install

3. Erstellen Sie das Projekt:

npm run build

4. 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

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 .