使用说明
项目简介
Nano Currency MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在使AI智能体(如LLM客户端)能够安全地与 Nano 加密货币网络进行交互。通过此服务器,AI智能体可以执行Nano币的发送以及查询账户和区块信息等操作。
主要功能点
- 发送 Nano 币 (nano_send): 允许AI智能体从预定义的 Nano 账户向指定地址发送 Nano 币。为了安全起见,可以设置最大发送金额限制。
- 查询账户信息 (nano_account_info): 允许AI智能体查询指定 Nano 地址的账户详细信息,包括余额、代表和最新区块等。
- 查询我的账户信息 (nano_my_account_info): 允许AI智能体查询预先配置的 Nano 账户的详细信息。这个账户通常用于发送 Nano 币。
- 查询区块信息 (block_info): 允许AI智能体查询指定 Nano 区块哈希的详细信息。
安装步骤
- 克隆仓库: 首先,使用 'git clone https://github.com/kilkelly/nano-currency-mcp-server.git' 命令将仓库克隆到本地。
- 进入目录: 使用 'cd nano-currency-mcp-server' 命令进入项目目录。
- 安装依赖: 运行 'npm install' 命令安装项目所需的 Node.js 依赖包。
服务器配置
MCP 客户端需要配置连接到 Nano Currency MCP Server 的信息。以下是一个配置示例,通常在 MCP 客户端的配置文件中进行设置(例如 Claude Desktop 的 'claude_desktop_config.json'):
{ "mcpServers": { "nano_currency": { // 服务器名称,客户端通过此名称识别 "command": "node", // 启动服务器的命令,这里使用 Node.js 运行 JavaScript 文件 "args": [ "nano-currency.js" // 服务器主程序的相对路径或绝对路径 ], "env": { // 环境变量配置,服务器运行时需要这些变量 "NANO_RPC_URL": "YOUR_NANO_RPC_URL", // **必需**: Nano 节点 RPC 的 URL,例如 "http://localhost:7076" 或远程节点地址 "NANO_WORK_GENERATION_URL": "YOUR_NANO_WORK_GENERATION_URL", // **可选**: 用于工作量证明生成的 URL,如果未设置,默认使用 NANO_RPC_URL "NANO_PRIVATE_KEY": "YOUR_NANO_PRIVATE_KEY", // **必需 (发送交易和查询我的账户信息时)**: 用于签名交易的 Nano 私钥,**注意:不是钱包种子!** 请使用小额 Nano 余额的账户私钥进行测试 "NANO_MAX_SEND_AMOUNT": "0.01" // **可选**: 最大发送 Nano 金额(单位:nano),默认为 0.01 nano。可以根据需要调整,但建议谨慎设置以防止意外损失 } } } }
配置参数说明:
- 'server name': 'nano_currency' - 服务器的唯一标识名称,客户端使用此名称来引用该服务器。
- 'command': 'node' - 运行服务器端代码的命令,通常是 Node.js 的 'node' 命令。
- 'args': '["nano-currency.js"]' - 传递给 'command' 的参数,指定服务器主程序 'nano-currency.js' 的路径。如果 'command' 是 'node',则 'args' 就是要执行的 JavaScript 文件。
- 'env': 环境变量,用于配置服务器的行为。
- 'NANO_RPC_URL': 必须配置,指向正在运行的 Nano 节点 RPC 接口的 URL。
- 'NANO_WORK_GENERATION_URL': 可选配置,如果你的 Nano 节点需要单独的工作量证明生成服务,则配置此项。如果你的 Nano 节点自身可以生成工作量证明,则可以省略此配置,默认会使用 'NANO_RPC_URL'。
- 'NANO_PRIVATE_KEY': 必须配置 (如果需要使用 'nano_send' 和 'nano_my_account_info' 工具), 这是用于发送 Nano 交易和查询我的账户信息的私钥。务必使用账户的私钥,而不是钱包种子,并谨慎保管私钥安全。建议先使用少量 Nano 进行测试。
- 'NANO_MAX_SEND_AMOUNT': 可选配置,设置单次 'nano_send' 工具调用的最大发送金额,单位为 nano。 默认值为 '0.01' nano。为了安全起见,建议保持较低的默认值或根据实际需求谨慎设置。
重要安全提示: 请务必妥善保管 'NANO_PRIVATE_KEY' 私钥,并强烈建议先使用小额 Nano 账户进行充分测试,确保理解工具的功能和潜在风险后再用于实际操作。
基本使用方法
- 启动服务器: 在 'nano-currency-mcp-server' 目录下,无需手动启动服务器。当 MCP 客户端(如 Claude Desktop)尝试连接配置的 MCP 服务器时,客户端会自动根据配置启动服务器进程。
- 在 MCP 客户端中使用: 在支持 MCP 协议的客户端(例如 Claude Desktop),配置好上述服务器连接信息后,客户端通常会自动检测并加载 MCP 服务器提供的工具。你可以通过自然语言提示词指示 AI 智能体使用这些工具。例如,在 Claude Desktop 中,你可以这样提问:
- "使用 nano_send 工具发送 0.001 nano 到地址 nano_xxxxxxxxxxxxx..." (请替换为实际的 Nano 地址)
- "使用 nano_account_info 工具查询地址 nano_yyyyyyyyyyyy..." (请替换为实际的 Nano 地址)
- "使用 nano_my_account_info 工具查询我的账户信息"
- "使用 block_info 工具查询区块哈希 xxxxxxxxxxxxxxxxx..." (请替换为实际的区块哈希)
AI 智能体会根据你的指令调用相应的 MCP 工具,并返回结果。请注意,具体的提示词格式可能因 MCP 客户端而异,请参考你使用的 MCP 客户端的文档。
免责声明: 使用本软件操作真实加密货币资产时,请务必谨慎。开发者不对因使用此软件造成的任何资金损失负责。
信息
分类
AI与计算