JinDaGe - nano_currency MCP Details

article

README

🚀 基于Nano货币的MCP服务器

本Model Context Protocol (MCP) 服务器支持兼容MCP的客户端（如部分AI代理），借助Nano节点RPC实现Nano货币的发送，同时可检索账户与区块信息。随着AI代理对MCP标准的采用日益广泛，该服务器能让它们依据所有者要求或在特定设置下自主发送Nano货币。

🚀 快速开始

此Model Context Protocol (MCP) 服务器支持兼容MCP的客户端（如部分AI代理），借助Nano节点RPC实现Nano货币的发送，同时可检索账户与区块信息。随着AI代理对MCP标准的采用日益广泛，该服务器能让它们依据所有者要求或在特定设置下自主发送Nano货币。

✨ 主要特性

发送Nano货币：通过签名交易将Nano货币从一个地址发送到另一个地址。
查询账户信息：获取特定Nano账户的余额和交易历史。
查询区块信息：检索区块链上的最新区块数据。

📚 详细文档

❔什么是MCP？

Model Context Protocol (MCP) 是一个开放框架，定义了应用程序向大型语言模型（LLMs）传递上下文的标准方式。

❔什么是 Nano 货币？

Nano是一种高性能的分布式账本协议，旨在实现快速、安全和环保的交易。它专注于可扩展性和低延迟，适合高频交易场景。

工具说明

1. 发送 Nano 货币

功能：将Nano货币从一个地址发送到另一个地址。
注意事项：
- 确保私钥安全，避免泄露。
- 默认最大发送金额为0.01 XRB（Nano的基本单位），如需调整，请谨慎设置。

2. 查询账户信息

功能：检索特定Nano账户的余额和交易记录。
示例查询：
- "显示我的Nano账户余额"
- "列出过去24小时内我的交易历史"

3. 查询区块信息

功能：获取区块链的最新区块数据，包括高度、时间戳和交易数量。

环境变量配置

为了使服务器正常运行，请在配置文件中设置以下环境变量：

| 变量名 | 作用 | |-----------------------|--------------------------------------------------------------------| | NANO_RPC_URL | 指定Nano节点的RPC接口地址，例如http://localhost:7076。 | | NANO_WORK_URL | （可选）指定用于交易验证的工作URL。如果未设置，默认使用 RPC 地址。| | NANO_PRIVATE_KEY | 用于签名交易的私钥（非钱包种子）。请勿泄露此密钥！ | | DEFAULT_MAX_SEND | （可选）默认最大发送金额，单位为XRB。默认值为0.01 XRB。 |

在Claude Desktop中使用

步骤 1：安装工具

打开Claude Desktop的设置界面。
导航至“工具”选项卡。
点击“添加新工具”按钮。
按照提示填写以下信息：
- 工具名称：Nano货币工具
- 工具描述：用于发送和查询 Nano 货币相关信息
- 可执行文件路径：C:\projects\nano-currency-mcp-server\nano-currency.js
点击“保存”完成安装。

步骤 2：配置环境变量

打开Claude Desktop的配置文件（通常位于用户目录下的.claude-desktop/tools/）。

在文件中添加以下内容：

NANO_RPC_URL=http://localhost:7076
NANO_PRIVATE_KEY=your_private_key_here
DEFAULT_MAX_SEND=0.01

保存并重启Claude Desktop。

步骤 3：使用工具

启动Claude Desktop后，您将在界面中看到新的Nano货币工具图标。
点击图标以查看工具描述和可用命令示例。
输入自然语言指令，例如：
- "向nano_address发送0.001 XRB"
- "查询我的 Nano 账户余额"

📄 许可证

本项目采用MIT许可证，具体内容请参考LICENSE文件。

常用提示信息

⚠️ 重要提示

在使用此软件时，请务必谨慎。由于LLM可能产生幻觉（即错误或不准确的信息），在执行任何实际操作之前，请始终验证指令和交易细节。使用此软件可能会导致资金损失。作者和贡献者不承担任何因使用此软件而导致的资金损失责任。请在测试环境中进行初步测试，确保私钥和交易逻辑的安全性。由于LLM的不确定性，请始终监控工具的行为，并在必要时手动干预。

💡 使用建议

建议在测试环境中进行初步测试，确保私钥和交易逻辑的安全性。同时，由于LLM的不确定性，要始终监控工具的行为，并在必要时手动干预。

nano_currency