bnbchain-mcp

BNBChain MCP (Modellkontextprotokoll)

Ein leistungsstarkes Toolkit für die Interaktion mit BNB Chain und anderen EVM-kompatiblen Netzwerken durch natürliche Sprachverarbeitung und KI-Unterstützung.

Beschreibung

BNBChain MCP ist eine Implementierung des Model Context Protocol, die eine nahtlose Interaktion mit Blockchain-Netzwerken über KI-gestützte Schnittstellen ermöglicht. Es bietet umfassende Tools und Ressourcen für die Blockchain-Entwicklung, die Interaktion mit Smart Contracts und das Netzwerkmanagement.

Kernmodule

Das Projekt ist in mehrere Kernmodule gegliedert:

Blöcke : Abfragen und Verwalten von Blockchain-Blöcken
Verträge : Interagieren Sie mit Smart Contracts
Netzwerk : Netzwerkinformationen und -verwaltung
NFT : NFT-Operationen (ERC721/ERC1155)
Token : Token-Operationen (ERC20)
Transaktionen : Transaktionsmanagement
Wallet : Wallet-Operationen und -Verwaltung
Gemeinsam : Gemeinsam genutzte Dienstprogramme und Typen
Greenfield : Unterstützt Dateiverwaltungsvorgänge im Greenfield-Netzwerk, einschließlich Hochladen, Herunterladen und Verwalten von Dateien und Buckets
Weitere Funktionen folgen in Kürze (Greenfield, Swap, Bridge usw.)

Integration mit Cursor

So stellen Sie von Cursor aus eine Verbindung zum MCP-Server her:

Öffnen Sie Cursor und gehen Sie zu Einstellungen (Zahnradsymbol oben rechts)
Klicken Sie in der linken Seitenleiste auf „MCP“
Klicken Sie auf „Neuen globalen MCP-Server hinzufügen“.
Geben Sie die folgenden Details ein:

Standardmodus

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optional)"
      }
    }
  }
}

SSE-Modus

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest", "--sse"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optional)"
      }
    }
  }
}

Integration mit Claude Desktop

So stellen Sie von Claude Desktop aus eine Verbindung zum MCP-Server her:

Öffnen Sie Claude Desktop und gehen Sie zu Einstellungen
Klicken Sie in der linken Seitenleiste auf „Entwickler“
Klicken Sie auf die Schaltfläche "Konfiguration bearbeiten"
Fügen Sie der Datei claude_desktop_config.json die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Speichern Sie die Datei und starten Sie Claude Desktop neu

Sobald Sie verbunden sind, können Sie alle MCP-Eingabeaufforderungen und -Tools direkt in Ihren Claude Desktop-Konversationen verwenden. Beispiel:

„Analysieren Sie diese Adresse: 0x123 …“
„Erklären Sie das EVM-Konzept von Gas“
„Überprüfen Sie den neuesten Block auf BSC“

Integration mit anderen Clients

Wenn Sie BNBChain MCP in Ihren eigenen Client integrieren möchten, sehen Sie sich bitte das Beispielverzeichnis an, um detailliertere Informationen und Referenzimplementierungen zu erhalten.

Die Beispiele zeigen:

So richten Sie den MCP-Client ein
Authentifizierung und Konfiguration
Tätigen von API-Aufrufen zur Interaktion mit Blockchain-Netzwerken
Umgang mit Antworten und Fehlern
Best Practices für die Integration

Lokale Entwicklung

Voraussetzungen

bun v1.2.10 oder höher
Node.js v17 oder höher

Schnellstart

Klonen Sie das Repository:

git clone https://github.com/bnb-chain/bnbchain-mcp.git
cd bnbchain-mcp

Umgebungsvariablen einrichten:

cp .env.example .env

Bearbeiten Sie .env -Datei mit Ihrer Konfiguration:

PRIVATE_KEY : Ihr privater Wallet-Schlüssel (erforderlich für Transaktionsvorgänge)
LOG_LEVEL : Protokollierungsebene festlegen (DEBUG, INFO, WARN, ERROR)
PORT : Server-Portnummer (Standard: 3001)

Installieren Sie Abhängigkeiten und starten Sie den Entwicklungsserver:

# Install project dependencies
bun install

# Start the development server
bun dev:sse

Testen mit MCP-Clients

Konfigurieren Sie den lokalen Server in Ihren MCP-Clients mithilfe dieser Vorlage:

{
  "mcpServers": {
    "bnbchain-mcp": {
      "url": "http://localhost:3001/sse",
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Testen mit der Web-Benutzeroberfläche

Wir verwenden @modelcontextprotocol/inspector zum Testen. Starten Sie die Test-Benutzeroberfläche:

bun run test

Verfügbare Skripte

bun dev:sse : Entwicklungsserver mit Hot Reload starten
bun build : Erstellen Sie das Projekt
bun test : Testsuite ausführen

Verfügbare Eingabeaufforderungen und Tools

Eingabeaufforderungen

Name	Beschreibung
Block analysieren	Analysieren Sie einen Block und geben Sie detaillierte Informationen zu seinem Inhalt an
Transaktion analysieren	Analysieren Sie eine bestimmte Transaktion
Adresse analysieren	Analysieren einer EVM-Adresse
mit dem Vertrag interagieren	Erhalten Sie Anleitungen zur Interaktion mit einem Smart Contract
explain_evm_concept	Erhalten Sie eine Erklärung eines EVM-Konzepts
Netzwerke vergleichen	Vergleichen Sie verschiedene EVM-kompatible Netzwerke
Analysetoken	Analysieren Sie einen ERC20- oder NFT-Token

Werkzeuge

Name	Beschreibung
get_block_by_hash	Holen Sie sich einen Block per Hash
Block nach Nummer abrufen	Holen Sie sich einen Block nach Nummer
get_latest_block	Holen Sie sich den neuesten Block
Transaktion abrufen	Erhalten Sie detaillierte Informationen zu einer bestimmten Transaktion anhand ihres Hashs
Transaktionsbeleg abrufen	Erhalten Sie eine Transaktionsbestätigung anhand ihres Hashs
Schätzung_Gas	Schätzen Sie die Gaskosten für eine Transaktion
Transfer_native_Token	Übertragen Sie native Token (BNB, ETH, MATIC usw.) an eine Adresse
Token-Ausgabe genehmigen	Genehmigen Sie eine andere Adresse zum Ausgeben Ihrer ERC20-Token
transfer_nft	Übertragen Sie ein NFT (ERC721-Token) von einer Adresse zu einer anderen
transfer_erc1155	Übertragen Sie ERC1155-Token an eine andere Adresse
transfer_erc20	Übertragen Sie ERC20-Token an eine Adresse
Adresse vom privaten Schlüssel abrufen	Holen Sie sich die aus einem privaten Schlüssel abgeleitete EVM-Adresse
Ketteninformationen abrufen	Abrufen von Ketteninformationen für ein bestimmtes Netzwerk
Get_Supported_Networks	Liste der unterstützten Netzwerke abrufen
resolve_ens	Einen ENS-Namen in eine EVM-Adresse auflösen
ist_Vertrag	Überprüfen Sie, ob es sich bei einer Adresse um einen Smart Contract oder ein extern verwaltetes Konto (EOA) handelt.
Vertrag lesen	Lesen Sie Daten aus einem Smart Contract, indem Sie eine View/Pure-Funktion aufrufen
Vertrag schreiben	Schreiben Sie Daten in einen Smart Contract, indem Sie eine Statusänderungsfunktion aufrufen
get_erc20_token_info	Informationen zum ERC20-Token abrufen
get_native_balance	Erhalten Sie das native Token-Guthaben für eine Adresse
get_erc20_balance	ERC20-Token-Guthaben für eine Adresse abrufen
get_nft_info	Erhalten Sie detaillierte Informationen zu einem bestimmten NFT
check_nft_ownership	Überprüfen Sie, ob eine Adresse ein bestimmtes NFT besitzt
get_erc1155_token_uri	Abrufen der Metadaten-URI für ein ERC1155-Token
get_nft_balance	Ermitteln Sie die Gesamtzahl der NFTs, die einer Adresse aus einer bestimmten Sammlung gehören
get_erc1155_balance	Holen Sie sich den Kontostand einer bestimmten ERC1155-Token-ID, die einer Adresse gehört
gnfd_get_bucket_info	Erhalten Sie detaillierte Informationen zu einem bestimmten Bucket
gnfd_list_buckets	Listet alle Buckets auf, die einer Adresse gehören
gnfd_create_bucket	Einen neuen Bucket erstellen
gnfd_delete_bucket	Löschen eines Buckets
gnfd_get_object_info	Erhalten Sie detaillierte Informationen zu einem bestimmten Objekt
gnfd_list_objects	Alle Objekte in einem Bucket auflisten
gnfd_upload_objekt	Hochladen eines Objekts in einen Bucket
gnfd_download_object	Herunterladen eines Objekts aus einem Bucket
gnfd_delete_object	Löschen eines Objekts aus einem Bucket
gnfd_Ordner erstellen	Erstellen eines Ordners in einem Bucket

Unterstützte Netzwerke

Unterstützt BSC, opBNB, Greenfield, Ethereum und andere wichtige EVM-kompatible Netzwerke. Weitere Informationen finden Sie src/evm/chains.ts .

Beitragen

Wir freuen uns über Beiträge zu BNBChain MCP! So können Sie helfen:

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Übernehmen Sie Ihre Änderungen
Pushen Sie zu Ihrem Zweig
Erstellen einer Pull-Anforderung

Bitte stellen Sie sicher, dass Ihr Code unseren Codierungsstandards entspricht und entsprechende Tests enthält.

Lizenz

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

Referenzen und Danksagungen

Dieses Projekt basiert auf den folgenden Open-Source-Projekten und ist von ihnen inspiriert:

TermiX-official/bsc-mcp – Ursprüngliche BSC MCP-Implementierung
mcpdotdirect/evm-mcp-server – EVM-kompatible MCP-Serverimplementierung

Wir danken den ursprünglichen Autoren für ihre Beiträge zum Blockchain-Ökosystem.

bnbchain-mcp

BNBChain MCP (Modellkontextprotokoll)

Beschreibung

Kernmodule

Integration mit Cursor

Integration mit Claude Desktop

Integration mit anderen Clients

Lokale Entwicklung

Voraussetzungen

Schnellstart

Testen mit MCP-Clients

Testen mit der Web-Benutzeroberfläche

Verfügbare Skripte

Verfügbare Eingabeaufforderungen und Tools

Eingabeaufforderungen

Werkzeuge

Unterstützte Netzwerke

Beitragen

Lizenz

Referenzen und Danksagungen

Tools

Related Resources

Related MCP Servers

ygocdb-mcp

dbt-mcpofficial

akshare-one-mcp

modbus-mcp

New MCP Servers

MCP directory API