Hive MCP Server

Hive MCP サーバー

Model Context Protocol を通じて、AI アシスタントが Hive ブロックチェーンとやり取りできるようにする MCP サーバーです。

概要

このサーバーは、AI アシスタント（Claude など）と Hive ブロックチェーンをつなぐ役割を果たし、AI モデルで次のことができます。

• アカウント情報と履歴を取得する
• ブログ投稿とディスカッションを取得する
• タグまたはユーザーで投稿を取得する
• コンテンツに投票し、投稿を作成する（適切な認証が必要です）
• HIVE または HBD トークンを他のアカウントに送信する
• Hive キーでメッセージに署名し、署名を検証する
• 暗号化されたメッセージを送受信する

機能

プロンプト

• create-post - 適切な形式とタグを使って新しい Hive 投稿を作成するよう、AI をガイドする構造化プロンプトを作成します
• analyze-account - Hive アカウントの統計、投稿履歴、活動パターンを分析するプロンプトを生成します

ツール

データの読み取り

• get_account_info - Hive ブロックチェーンアカウントの詳細情報を取得します
• get_post_content - 投稿者とパーマリンクを指定して特定の投稿を取得します
• get_posts_by_tag - タグとカテゴリー（トレンド、ホットなど）で投稿を取得します
• get_posts_by_user - 特定のユーザーまたはそのフィードから投稿を取得します
• get_account_history - アカウントのトランザクション履歴を取得します。操作による絞り込みも指定できます
• get_chain_properties - Hive ブロックチェーンの現在のプロパティと統計を取得します
• get_vesting_delegations - 特定のアカウントが行ったベスティング委任の一覧を取得します

ブロックチェーンとのやり取り（認証が必要）

• vote_on_post - Hive コンテンツに投票します（投稿キーが必要です）
• create_post - Hive ブロックチェーン上に新しいブログ投稿を作成します（投稿キーが必要です）
• create_comment - 既存の投稿にコメントしたり、コメントに返信したりします（投稿キーが必要です）
• send_token - HIVE または HBD 暗号通貨を他のアカウントに送信します（アクティブキーが必要です）

暗号技術

• sign_message - Hive の秘密鍵を使ってメッセージに署名します
• verify_signature - Hive の公開鍵に照らしてメッセージの署名を検証します

暗号化メッセージ

• encrypt_message - 特定の Hive アカウント宛てのメッセージを暗号化します
• decrypt_message - 特定の Hive アカウントからの暗号化メッセージを復号します
• send_encrypted_message - トークンの送金を使って暗号化メッセージを送信します
• get_encrypted_messages - アカウント履歴からメッセージを取得し、必要に応じて復号します

MCP Inspector でのデバッグ

MCP Inspector は、サーバーのテストとデバッグに使える対話型インターフェースを提供します。

npx @modelcontextprotocol/inspector npx @gluneau/hive-mcp-server

認証の設定

認証が必要な操作（投票、投稿、トークンの送信）を有効にするには、環境変数を設定する必要があります。

export HIVE_USERNAME=your-hive-username
export HIVE_POSTING_KEY=your-hive-posting-private-key  # For content operations
export HIVE_ACTIVE_KEY=your-hive-active-private-key    # For token transfers
export HIVE_MEMO_KEY=your-hive-memo-private-key        # For encrypted messaging

セキュリティに関する注意：秘密鍵を共有したり、バージョン管理にコミットしたりしないでください。環境変数を使用するか、安全な設定方法を利用してください。

AI アシスタントとの連携

Claude Desktop

このサーバーを Claude Desktop で使用するには、次の手順に従ってください。

1. Claude Desktop がインストールされていることを確認します

2. Claude の設定ファイルを開くか、新規作成します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

3. このサーバーを設定に追加します。

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "@gluneau/hive-mcp-server"],
      "env": {
        "HIVE_USERNAME": "your-hive-username",
        "HIVE_POSTING_KEY": "your-hive-posting-private-key",
        "HIVE_ACTIVE_KEY": "your-hive-active-private-key",
        "HIVE_MEMO_KEY": "your-hive-memo-private-key"
      }
    }
  }
}

Windsurf と Cursor

同じ JSON 設定は、Windsurf（windsurf_config.json）および Cursor（バージョン >= 0.47 の場合は ~/.cursor/mcp.json）で使用できます。

以前のバージョンでは、Settings の MCP セクションで 1 行のコマンド形式を使用する必要があります： 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

例

MCP クライアントに接続すると、次のような質問をすることができます：

• 「Hive の #photography タグでトレンドになっている投稿は何ですか？」
• 「ユーザー名 'alice' の最近の投稿を表示してください」
• 「'bob' のアカウント残高と詳細を教えてください」
• 「'charlie' の取引履歴を取得してください」
• 「'dave' の permlink 'my-awesome-post' の投稿に賛成票を投じられますか？」
• 「AI 技術について Hive に新しい投稿を作成してください」
• 「メモ 'Thanks for your help!' を添えて、ユーザー 'frank' に 1 HIVE を送金してください」
• 「Hive の投稿キーでこのメッセージに署名してください：'Verifying my identity'」
• 「現在の Hive ブロックチェーンのプロパティは何ですか？」
• 「ユーザー 'grace' が行ったベスティング委任を表示してください」
• 「このメッセージをユーザー 'alice' 向けに暗号化してください：'This is a secret message'」
• 「'bob' からのこのメッセージを復号してください：'#4f3a5b...'」
• 「'charlie' に 'Let's meet tomorrow' と暗号化メッセージを送信してください」
• 「自分の暗号化メッセージを表示して復号してください」
• 「'dave' とやり取りした直近 10 件の暗号化メッセージを取得してください」

ツールドキュメント

get_account_info

残高、権限、投票力、その他の指標を含む、Hive ブロックチェーンアカウントの詳細情報を取得します。

• パラメーター：
  • username：情報を取得する Hive ユーザー名

get_post_content

作者と permlink で特定される Hive のブログ投稿を取得します。

• パラメーター：
  • author：投稿の作者
  • permlink：投稿の permlink

get_posts_by_tag

指定したタグで Hive の投稿を絞り込み、カテゴリ別に並べ替えて取得します。

• パラメーター：
  • category：並べ替えカテゴリ（trending、hot、created など）
  • tag：投稿を絞り込むタグ
  • limit：取得する投稿数（1～20）

get_posts_by_user

特定の Hive ユーザーが作成した投稿、またはそのユーザーのフィード内の投稿を取得します。

• パラメーター：
  • category：取得するユーザー投稿の種類（blog または feed）
  • username：投稿を取得する Hive ユーザー名
  • limit：取得する投稿数（1～20）

get_account_history

操作タイプによる任意の絞り込みを指定して、Hive アカウントの取引履歴を取得します。

• パラメーター：
  • username：Hive ユーザー名
  • limit：取得する操作数
  • operation_filter：絞り込み対象とする操作タイプの任意のリスト

get_chain_properties

Hive ブロックチェーンのプロパティと統計情報を取得します。

• パラメーター：なし

get_vesting_delegations

特定の Hive アカウントが行ったベスティング委任の一覧を取得します。

• パラメーター：
  • username：委任を取得する Hive アカウント
  • limit：取得する委任の最大数
  • from：ページネーションの開始アカウント（任意）

vote_on_post

設定済みの Hive アカウントを使用して、Hive の投稿に投票（賛成票または反対票）します。

• パラメーター：
  • author：投票する投稿の作者
  • permlink：投票する投稿の permlink
  • weight：投票の重み。-10000（100% の反対票）から 10000（100% の賛成票）まで

create_post

設定済みのアカウントを使用して、Hive ブロックチェーンに新しいブログ投稿を作成します。

• パラメーター：
  • title：ブログ投稿のタイトル
  • body：ブログ投稿の内容（Markdown 対応）
  • tags：投稿のタグ
  • 報酬、受益者などに関する各種オプションパラメーター

create_comment

既存の Hive 投稿にコメントを作成するか、別のコメントに返信します。

• パラメーター：
  • parent_author：投稿者、または返信先のコメントを書いたユーザー名
  • parent_permlink：投稿、または返信先のコメントの Permlink
  • body：コメントの内容（Markdown に対応）
  • 報酬、受益者などに関する各種オプションパラメーター

send_token

設定済みのアカウントを使用して、別の Hive アカウントに HIVE または HBD トークンを送信します。

• パラメーター：
  • to：送信先の Hive ユーザー名
  • amount：送信するトークンの量
  • currency：送信する通貨（HIVE または HBD）
  • memo：トランザクションに含める任意のメモ

sign_message

環境変数に設定された Hive 秘密鍵を使用してメッセージに署名します。

• パラメーター：
  • message：署名するメッセージ
  • key_type：使用する鍵の種類（posting、active、または memo）

verify_signature

Hive 公開鍵に対してデジタル署名を検証します。

• パラメーター：
  • message_hash：16 進形式のメッセージの SHA-256 ハッシュ
  • signature：検証する署名文字列
  • public_key：検証に使用する公開鍵

encrypt_message

メモ暗号化を使用して、特定の Hive アカウント宛てにメッセージを暗号化します。

• パラメーター：
  • message：暗号化するメッセージ
  • recipient：受信者の Hive ユーザー名

decrypt_message

特定の Hive アカウントから受信した暗号化メッセージを復号します。

• パラメーター：
  • encrypted_message：暗号化メッセージ（# で始まります）
  • sender：送信者の Hive ユーザー名

send_encrypted_message

少額のトークン送金を使用して、Hive アカウントに暗号化メッセージを送信します。

• パラメーター：
  • message：暗号化して送信するメッセージ
  • recipient：受信者の Hive ユーザー名
  • amount：送信する HIVE の量（最小 0.001、デフォルト：0.001）

get_encrypted_messages

アカウント履歴から暗号化メッセージを取得します。復号は任意です。

• パラメーター：
  • username：暗号化メッセージを取得する Hive ユーザー名
  • limit：取得するメッセージの最大数（デフォルト：20）
  • decrypt：メッセージの復号を試みるかどうか（デフォルト：false）

開発

プロジェクト構成

• src/index.ts - メインサーバーの実装
• src/tools/ - すべてのツールの実装
• src/schemas/ - ツールパラメーターの Zod スキーマ
• src/utils/ - Hive ブロックチェーンとのやり取りに使用するユーティリティ関数
• src/config/ - クライアント設定とログレベルの処理

依存関係

• @hiveio/dhive - Hive ブロックチェーンクライアント
• @modelcontextprotocol/sdk - MCP SDK
• zod - スキーマ検証

ライセンス

ISC

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

詳しい貢献ガイドラインについては、CONTRIBUTING.md ファイルをご覧ください。