使用说明

项目简介

Hive MCP Server 是一个 Model Context Protocol (MCP) 服务器的实现,旨在连接 AI 助手(如 Claude)和 Hive 区块链。它允许 AI 模型通过标准化的 MCP 协议与 Hive 区块链进行交互,从而扩展 AI 助手的功能,使其能够访问和操作 Hive 区块链上的数据和功能。

主要功能点

  • 数据读取: 获取 Hive 账户信息、账户历史、帖子内容、用户帖子、标签帖子、区块链属性和投票代理信息。
  • 区块链交互: 支持对帖子进行投票、创建帖子和评论、发送 HIVE/HBD 代币(均需身份验证)。
  • 加密功能: 提供消息签名和验证功能,保障数据安全。
  • 加密消息: 支持发送、接收和解密加密消息,保护用户通信隐私。

安装步骤

  1. 前提条件: 确保已安装 Node.js 和 npm (或 yarn)。
  2. 克隆仓库: 在终端中执行命令 'git clone https://github.com/gluneau/hive-mcp-server.git' 将仓库克隆到本地。
  3. 进入目录: 使用 'cd hive-mcp-server' 命令进入项目目录。
  4. 安装依赖: 运行 'npm install' 或 'yarn install' 安装项目所需的依赖包。
  5. 构建项目: 执行 'npm run build' 或 'yarn build' 命令编译 TypeScript 代码。

服务器配置(MCP客户端配置)

以下 JSON 配置信息用于配置 MCP 客户端(例如 Claude Desktop, Windsurf, Cursor)以连接到 Hive MCP Server。请将以下配置添加到你的 MCP 客户端的配置文件中(例如 'claude_desktop_config.json', 'windsurf_config.json', 'cursor_config.json')。

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "@gluneau/hive-mcp-server"],
      "env": {
        "HIVE_USERNAME": "your-hive-username",  // (可选) 你的 Hive 用户名,用于需要身份验证的功能。
        "HIVE_POSTING_KEY": "your-hive-posting-private-key", // (可选) 你的 Hive 发布私钥,用于内容操作,如投票、发帖和评论。
        "HIVE_ACTIVE_KEY": "your-hive-active-private-key",   // (可选) 你的 Hive 活跃私钥,用于代币转账。
        "HIVE_MEMO_KEY": "your-hive-memo-private-key"       // (可选) 你的 Hive 备忘录私钥,用于加密消息功能。
      }
    }
  }
}

配置说明:

  • '"server name"': '"hive"' - 服务器名称,在 MCP 客户端中用于标识和选择此服务器。
  • '"command"': '"npx"' - 用于启动服务器的命令,这里使用 'npx' 运行 npm 包。
  • '"args"': '["-y", "@gluneau/hive-mcp-server"]' - 传递给 'npx' 的参数,指定要运行的 npm 包 '@gluneau/hive-mcp-server'。 '-y' 参数用于自动确认执行 npm 包。
  • '"env"': 环境变量配置,用于服务器的身份验证和功能启用。
    • '"HIVE_USERNAME"': 你的 Hive 用户名。
    • '"HIVE_POSTING_KEY"': 你的 Hive 发布私钥。
    • '"HIVE_ACTIVE_KEY"': 你的 Hive 活跃私钥。
    • '"HIVE_MEMO_KEY"': 你的 Hive 备忘录私钥。 请务必替换占位符 '"your-hive-..."' 为你真实的 Hive 账户信息。 私钥是敏感信息,请妥善保管,并推荐使用环境变量等安全方式配置,避免硬编码在配置文件中。

基本使用方法

完成 MCP 客户端配置后,启动你的 MCP 客户端(如 Claude Desktop)。在客户端中选择已配置的 "hive" 服务器。现在你可以通过自然语言指令,让 AI 助手与 Hive 区块链进行交互。例如,你可以提问:

  • "What are the trending posts in the #photography tag on Hive?" (查询 Hive 上 #photography 标签的热门帖子)
  • "Show me the recent posts from username 'alice'" (查看用户 'alice' 的最新帖子)
  • "What's the account balance and details for 'bob'?" (查询用户 'bob' 的账户余额和账户详情)
  • "Can you upvote the post by 'dave' with permlink 'my-awesome-post'?" (请求为用户 'dave' 的某篇帖子点赞)

根据你的 MCP 客户端的功能,你可以利用更多工具与 Hive 区块链进行互动。

信息

分类

商业系统