Hathor MCP

哈索尔MCP

用于Hathor网络的MCP（模型上下文协议）服务器。将Claude等AI助手连接到任何Hathor全节点。

特性

• 查询区块链状态（区块、交易、节点状态）
• 通过钱包无头管理钱包（创建、充值、发送、检查余额）
• 使用纳米合约/蓝图（发布、创建、执行、查询状态）
• 水龙头操作（从fullnode的内置钱包发送）
• 两种传输模式：HTTP和stdio（适用于Claude Desktop）

快速开始

# Build
cargo build --release

# Run with default settings (fullnode at localhost:8080)
./target/release/hathor-mcp

# Connect to a specific fullnode
./target/release/hathor-mcp \
  --fullnode-url http://my-node:8080 \
  --wallet-headless-url http://my-node:8001

# Use stdio transport for Claude Desktop
./target/release/hathor-mcp --stdio

CLI选项

认证

HTTP模式要求每个节点上都有一个承载令牌 /mcp 和 /mcp/sse 请求：

Authorization: Bearer 

如果 --auth-token 和 HATHOR_MCP_TOKEN 如果两者都未设置，启动时会生成一个随机的32字节令牌并打印到stderr。集 HATHOR_MCP_TOKEN （或 --auth-token)在重启过程中重复使用固定值。使用 --no-auth 仅当您确定没有其他进程可以到达该端口时，才在环回绑定上。

这 /health 端点未经身份验证，因此容器编排器可以对其进行健康检查。

MCP配置

克劳德代码（.mcp.json）

{
  "mcpServers": {
    "hathor": {
      "type": "http",
      "url": "http://127.0.0.1:9876/mcp"
    }
  }
}

克劳德桌面

{
  "mcpServers": {
    "hathor": {
      "command": "/path/to/hathor-mcp",
      "args": ["--stdio", "--fullnode-url", "http://127.0.0.1:8080"]
    }
  }
}

可用工具

区块链

• get_node_status --节点状态、块高度、网络信息
• get_blocks --最近区块（可配置计数）
• get_transaction --按哈希计算的交易详细信息

钱包操作

• generate_seed --生成BIP39种子短语
• create_wallet / close_wallet --管理钱包。生成的种子在中内联返回 create_wallet的响应，并且从不存储在服务器端
• get_wallet_status / get_wallet_balance / get_wallet_addresses
• send_from_wallet --发送HTR

水龙头

• get_faucet_balance --全节点钱包余额
• send_from_faucet --从全节点钱包发送
• fund_wallet --从水龙头自动充值钱包

纳米合约

• list_blueprints / get_blueprint_info
• publish_blueprint --在链上部署Python蓝图
• create_nano_contract --实例化蓝图
• execute_nano_contract --调用合约方法
• get_nano_contract_state / get_nano_contract_history / get_nano_contract_logs

配置

• get_service_urls --检查配置的端点URL（URL在启动时是固定的）

许可证

麻省理工学院