Hive MCP Server

Hive MCP 服务

一个 MCP 服务，可通过 Model Context Protocol 让 AI 助手与 Hive 区块链交互。

概述

此服务在 AI 助手（如 Claude）与 Hive 区块链之间搭建桥梁，让 AI 模型能够：

• 获取账户信息和历史记录
• 检索博客文章和讨论
• 按标签或用户获取文章
• 对内容投票并创建文章（需正确完成身份验证）
• 向其他账户发送 HIVE 或 HBD 代币
• 使用 Hive 密钥签署和验证消息
• 发送和接收加密消息

功能

提示词

• create-post - 创建结构化提示词，引导 AI 按照正确的格式和标签撰写新的 Hive 文章
• analyze-account - 生成提示词，用于分析 Hive 账户的统计数据、发文历史和活动模式

工具

读取数据

• get_account_info - 获取 Hive 区块链账户的详细信息
• get_post_content - 按作者和 permlink 检索指定文章
• get_posts_by_tag - 按标签和类别（trending、hot 等）检索文章
• get_posts_by_user - 获取指定用户的文章或其信息流
• get_account_history - 获取账户的交易历史记录，可选择按操作类型筛选
• get_chain_properties - 获取当前 Hive 区块链属性和统计数据
• get_vesting_delegations - 获取指定账户发出的权利委托列表

区块链交互（需要身份验证）

• vote_on_post - 对 Hive 内容投票（需要 posting key）
• create_post - 在 Hive 区块链上创建新的博客文章（需要 posting key）
• create_comment - 评论现有文章或回复评论（需要 posting key）
• send_token - 向其他账户发送 HIVE 或 HBD 加密货币（需要 active key）

密码学

• 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 部分使用单行命令格式： 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' 的帖子投赞成票吗？”
• “在 Hive 上发布一篇关于 AI 技术的新帖子”
• “向用户 'frank' 转账 1 HIVE，并附上备注 'Thanks for your help!'”
• “使用我的 Hive posting key 签署这条消息：'Verifying my identity'”
• “当前 Hive 区块链的属性有哪些？”
• “显示用户 'grace' 做出的 vesting 委托”
• “为用户 '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 账户做出的 vesting 委托列表。

• 参数：
  • 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：帖子或要回复的评论的永久链接
  • 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：消息的 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

贡献

欢迎贡献！请随时提交 Pull Request。

有关更详细的贡献指南，请参阅 CONTRIBUTING.md 文件。