Hive MCP-Server

Ein MCP-Server, der es KI-Assistenten ermöglicht, über das Model Context Protocol mit der Hive-Blockchain zu interagieren.

Überblick

Dieser Server stellt eine Brücke zwischen KI-Assistenten (wie Claude) und der Hive-Blockchain her und ermöglicht KI-Modellen:

• Kontoinformationen und Verlauf abrufen

• Blogbeiträge und Diskussionen abrufen

• Beiträge nach Tag oder Benutzer abrufen

• Über Inhalte abstimmen und Beiträge erstellen (bei ordnungsgemäßer Authentifizierung)

• Senden Sie HIVE- oder HBD-Token an andere Konten

• Signieren und verifizieren Sie Nachrichten mit Hive-Schlüsseln

• Senden und Empfangen verschlüsselter Nachrichten

Merkmale

Eingabeaufforderungen

• create-post – Erstellt eine strukturierte Eingabeaufforderung, um die KI durch die Erstellung eines neuen Hive-Beitrags mit dem richtigen Format und den richtigen Tags zu führen

• analyze-account - Generiert eine Eingabeaufforderung zur Analyse der Statistiken, des Veröffentlichungsverlaufs und der Aktivitätsmuster eines Hive-Kontos

Werkzeuge

Daten lesen

• get_account_info – Erhalten Sie detaillierte Informationen zu einem Hive-Blockchain-Konto

• get_post_content - Einen bestimmten Beitrag nach Autor und Permalink abrufen

• get_posts_by_tag – Beiträge nach Tag und Kategorie abrufen (Trend, heiß usw.)

• get_posts_by_user – Beiträge von einem bestimmten Benutzer oder dessen Feed abrufen

• get_account_history - Transaktionsverlauf für ein Konto abrufen, mit optionaler Vorgangsfilterung

• get_chain_properties – Aktuelle Hive-Blockchain-Eigenschaften und -Statistiken abrufen

• get_vesting_delegations - Ruft eine Liste der Vesting-Delegationen ab, die von einem bestimmten Konto vorgenommen wurden.

Blockchain-Interaktionen (Authentifizierung erforderlich)

• vote_on_post – Über Hive-Inhalte abstimmen (erfordert Posting-Schlüssel)

• create_post – Neue Blogbeiträge in der Hive-Blockchain erstellen (erfordert Posting-Schlüssel)

• create_comment – Kommentieren Sie vorhandene Beiträge oder antworten Sie auf Kommentare (erfordert Posting-Schlüssel)

• send_token – Senden Sie HIVE- oder HBD-Kryptowährung an andere Konten (erfordert aktiven Schlüssel)

Kryptographie

• sign_message – Signieren Sie eine Nachricht mit einem privaten Hive-Schlüssel

• verify_signature – Überprüfen einer Nachrichtensignatur anhand eines öffentlichen Hive-Schlüssels

Verschlüsselte Nachrichten

• encrypt_message – Verschlüsseln Sie eine Nachricht für ein bestimmtes Hive-Konto

• decrypt_message – Entschlüsseln Sie eine verschlüsselte Nachricht von einem bestimmten Hive-Konto

• send_encrypted_message – Senden Sie eine verschlüsselte Nachricht mithilfe einer Tokenübertragung

• get_encrypted_messages - Nachrichten aus dem Kontoverlauf abrufen und optional entschlüsseln

Debuggen mit MCP Inspector

Der MCP Inspector bietet eine interaktive Schnittstelle zum Testen und Debuggen des Servers:

Authentifizierungskonfiguration

Um authentifizierte Vorgänge (Abstimmen, Posten, Senden von Token) zu ermöglichen, müssen Sie Umgebungsvariablen festlegen:

Sicherheitshinweis : Geben Sie Ihre privaten Schlüssel niemals weiter und übergeben Sie sie nicht der Versionskontrolle. Verwenden Sie Umgebungsvariablen oder einen sicheren Konfigurationsansatz.

Integration mit KI-Assistenten

Claude Desktop

So verwenden Sie diesen Server mit Claude Desktop:

1. Stellen Sie sicher, dass Sie Claude Desktop installiert haben

2. Öffnen oder erstellen Sie die Claude-Konfigurationsdatei:

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

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

3. Fügen Sie diesen Server zu Ihrer Konfiguration hinzu:

Windsurfen und Cursor

Die gleiche JSON-Konfiguration funktioniert für Windsurf (in windsurf_config.json ) und für Cursor (in ~/.cursor/mcp.json für Version >= 0.47).

In früheren Versionen mussten Sie im MCP-Abschnitt der Einstellungen das 1-zeilige Befehlsformat verwenden: env HIVE_USERNAME=your-hive-username env HIVE_POSTING_KEY=your-hive-posting-private-key env HIVE_ACTIVE_KEY=your-hive-active-private-key env HIVE_MEMO_KEY=your-hive-memo-private-key npx -y @gluneau/hive-mcp-server

Beispiele

Sobald Sie mit einem MCP-Client verbunden sind, können Sie Fragen stellen wie:

• „Was sind die Trendbeiträge im Tag #Fotografie auf Hive?“

• „Zeige mir die letzten Beiträge vom Benutzernamen ‚Alice‘“

• „Wie ist der Kontostand und die Kontodetails für ‚Bob‘?“

• „Transaktionsverlauf für ‚Charlie‘ abrufen“

• „Können Sie den Beitrag von ‚Dave‘ mit dem Permalink ‚my-awesome-post‘ positiv bewerten?“

• „Erstellen Sie auf Hive einen neuen Beitrag zum Thema KI-Technologie.“

• „Senden Sie 1 HIVE an den Benutzer ‚Frank‘ mit dem Vermerk ‚Danke für Ihre Hilfe!‘“

• „Signieren Sie diese Nachricht mit meinem Hive-Posting-Schlüssel: ‚Meine Identität wird bestätigt‘“

• „Was sind die aktuellen Eigenschaften der Hive-Blockchain?“

• „Zeigen Sie mir die vom Benutzer ‚Grace‘ vorgenommenen Übertragungen.“

• „Verschlüsseln Sie diese Nachricht für Benutzer ‚Alice‘: ‚Dies ist eine geheime Nachricht‘“

• „Entschlüsseln Sie diese Nachricht von ‚Bob‘: ‚#4f3a5b…‘“

• „Senden Sie eine verschlüsselte Nachricht an ‚Charlie‘ mit dem Inhalt ‚Lass uns morgen treffen‘.“

• „Zeigen Sie mir meine verschlüsselten Nachrichten und entschlüsseln Sie sie“

• „Holen Sie sich die letzten 10 verschlüsselten Nachrichten, die ich mit ‚Dave‘ ausgetauscht habe.“

Tool-Dokumentation

get_account_info

Ruft detaillierte Informationen zu einem Hive-Blockchain-Konto ab, einschließlich Kontostand, Autorität, Stimmrecht und anderen Kennzahlen.

• Parameter:

  • username : Hive-Benutzername zum Abrufen von Informationen

get_post_content

Ruft einen bestimmten Hive-Blogbeitrag ab, der durch Autor und Permalink identifiziert wird.

• Parameter:

  • author : Autor des Beitrags

  • permlink : Permalink des Beitrags

get_posts_by_tag

Ruft Hive-Beiträge ab, die nach einem bestimmten Tag gefiltert und nach einer Kategorie sortiert sind.

• Parameter:

  • category : Sortierkategorie (Trend, heiß, erstellt usw.)

  • tag : Das Tag, nach dem Beiträge gefiltert werden sollen

  • limit : Anzahl der zurückzugebenden Beiträge (1-20)

get_posts_by_user

Ruft Beiträge ab, die von einem bestimmten Hive-Benutzer verfasst wurden oder sich im Feed eines bestimmten Hive-Benutzers befinden.

• Parameter:

  • category : Art der abzurufenden Benutzerbeiträge (Blog oder Feed)

  • username : Hive-Benutzername zum Abrufen von Beiträgen

  • limit : Anzahl der zurückzugebenden Beiträge (1-20)

get_account_history

Ruft den Transaktionsverlauf für ein Hive-Konto mit optionaler Filterung nach Vorgangstyp ab.

• Parameter:

  • username : Hive-Benutzername

  • limit : Anzahl der zurückzugebenden Operationen

  • operation_filter : Optionale Liste der Operationstypen, nach denen gefiltert werden soll

get_chain_properties

Rufen Sie aktuelle Eigenschaften und Statistiken der Hive-Blockchain ab.

• Parameter: Keine

get_vesting_delegations

Erhalten Sie eine Liste der von einem bestimmten Hive-Konto vorgenommenen Übertragungen.

• Parameter:

  • username : Hive-Konto, für das Delegationen abgerufen werden sollen

  • limit : Maximale Anzahl abzurufender Delegationen

  • from : Optionales Startkonto für die Paginierung

vote_on_post

Stimmen Sie mit dem konfigurierten Hive-Konto über einen Hive-Beitrag ab (Upvote oder Downvote).

• Parameter:

  • author : Autor des Beitrags, über den abgestimmt werden soll

  • permlink : Permalink des Beitrags, über den abgestimmt werden soll

  • weight : Stimmengewichtung von -10000 (100 % Downvote) bis 10000 (100 % Upvote)

create_post

Erstellen Sie mit dem konfigurierten Konto einen neuen Blogbeitrag in der Hive-Blockchain.

• Parameter:

  • title : Titel des Blogbeitrags

  • body : Inhalt des Blogbeitrags (Markdown unterstützt)

  • tags : Tags für den Beitrag

  • Verschiedene optionale Parameter für Belohnungen, Begünstigte usw.

create_comment

Erstellen Sie einen Kommentar zu einem vorhandenen Hive-Beitrag oder antworten Sie auf einen anderen Kommentar.

• Parameter:

  • parent_author : Benutzername des Beitragsautors oder Kommentars, auf den Sie antworten

  • parent_permlink : Permalink des Beitrags oder Kommentars, auf den Sie antworten

  • body : Inhalt des Kommentars (Markdown unterstützt)

  • Verschiedene optionale Parameter für Belohnungen, Begünstigte usw.

send_token

Senden Sie HIVE- oder HBD-Token mithilfe des konfigurierten Kontos an ein anderes Hive-Konto.

• Parameter:

  • to : Empfänger-Hive-Benutzername

  • amount : Anzahl der zu sendenden Token

  • currency : Zu sendende Währung (HIVE oder HBD)

  • memo : Optionales Memo, das der Transaktion beigefügt werden soll

sign_message

Signieren Sie eine Nachricht mit einem privaten Hive-Schlüssel aus Umgebungsvariablen.

• Parameter:

  • message : Zu unterschreibende Nachricht

  • key_type : Zu verwendender Schlüsseltyp (Posting, Active oder Memo)

verify_signature

Überprüfen Sie eine digitale Signatur anhand eines öffentlichen Hive-Schlüssels.

• Parameter:

  • message_hash : Der SHA-256-Hash der Nachricht im Hex-Format

  • signature : Zu überprüfende Signaturzeichenfolge

  • public_key : Öffentlicher Schlüssel zur Überprüfung

encrypt_message

Verschlüsseln Sie eine Nachricht für ein bestimmtes Hive-Konto mithilfe der Memo-Verschlüsselung.

• Parameter:

  • message : Zu verschlüsselnde Nachricht

  • recipient : Hive-Benutzername des Empfängers

decrypt_message

Entschlüsseln Sie eine verschlüsselte Nachricht, die von einem bestimmten Hive-Konto empfangen wurde.

• Parameter:

  • encrypted_message : Verschlüsselte Nachricht (beginnt mit #)

  • sender : Hive-Benutzername des Absenders

send_encrypted_message

Senden Sie mithilfe einer kleinen Token-Übertragung eine verschlüsselte Nachricht an ein Hive-Konto.

• Parameter:

  • message : Zu verschlüsselnde und zu sendende Nachricht

  • recipient : Hive-Benutzername des Empfängers

  • amount : Zu sendende HIVE-Menge (mindestens 0,001, Standard: 0,001)

get_encrypted_messages

Rufen Sie verschlüsselte Nachrichten aus dem Kontoverlauf mit optionaler Entschlüsselung ab.

• Parameter:

  • username : Hive-Benutzername zum Abrufen verschlüsselter Nachrichten

  • limit : Maximale Anzahl abzurufender Nachrichten (Standard: 20)

  • decrypt : Ob eine Entschlüsselung der Nachrichten versucht werden soll (Standard: false)

Entwicklung

Projektstruktur

• src/index.ts – Hauptserverimplementierung

• src/tools/ - Implementierung aller Tools

• src/schemas/ – Zod-Schemata für Werkzeugparameter

• src/utils/ – Dienstprogrammfunktionen für die Interaktion mit der Hive-Blockchain

• src/config/ - Client-Konfiguration und Protokollebenenverwaltung

Abhängigkeiten

• @hiveio/dhive – Hive-Blockchain-Client

• @modelcontextprotocol/sdk – MCP SDK

• zod - Schemavalidierung

Lizenz

ISC

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Ausführlichere Richtlinien für Beiträge finden Sie in der Datei CONTRIBUTING.md .