Nano Currency MCP Server

Nano 货币 MCP 服务

Nano Currency MCP Server 让兼容 MCP 的客户端（包括 AI Agent）能够通过 Nano 节点 RPC 发送 Nano 货币并获取账户和区块信息。

AI Agent 正在日益采用 MCP 标准，而此服务让它们能够根据所有者的请求发送 Nano；在某些设置中，也可能自主发送 🤖

Nano Currency MCP Server 还支持创建兼容 x402 的标头，让 AI Agent 能够使用 Nano 为 API／资源付费。

❔ 什么是 MCP？

模型上下文协议（MCP）是一种开放框架，它为应用程序向大语言模型（LLM）提供上下文定义了标准化方法。

❔ 什么是 Nano 货币？

Nano 是一种数字货币，旨在实现快速、可扩展且免手续费的交易。它致力于解决传统加密货币中的常见问题，例如高手续费和处理速度慢，因此适合用于日常点对点支付。了解更多信息，请访问 nano.org

❔ 什么是 x402？

x402 是一种原生于互联网的支付协议，它重新启用未使用的 HTTP 402 Payment Required 状态码，以实现通过网络进行即时、可编程且无需许可的支付。了解更多信息，请访问 x402.org。Nano 专用的 x402 方案和实现代码可在 x402nano GitHub 资源库中找到。

🚨 继续操作前请注意 🚨

注意：大模型可能会产生幻觉，且不一定会按预期执行，因此请使用少量 Nano 测试此服务。使用后文介绍的 RAW_MAX_SEND_AMOUNT 或 NANO_MAX_SEND_AMOUNT 环境变量，限制每次可发送的 Nano 最大数量。

🛠️ Nano Currency MCP Server 提供的工具

🔧 raw_send - 将指定数量的 raw 单位从预设的 Nano 账户发送到目标 Nano 账户。

🔧 nano_send - 将指定数量的 nano 单位从预设的 Nano 账户发送到目标 Nano 账户。

🔧 nano_account_info - 获取特定 Nano 账户的详细信息，包括余额（以 nano 和 raw 单位计）、代表和前沿区块。

🔧 nano_my_account_info - 获取我的 Nano 账户的详细信息，包括余额（以 nano 和 raw 单位计）、代表和前沿区块。此账户用于发送 Nano。

🔧 block_info - 获取特定 Nano 区块的详细信息。

🔧 x402_payment_signature_exact_scheme_create - 为符合 exact 方案的 Nano x402 交易创建 PAYMENT-SIGNATURE 标头。

🔌 安装

确保系统已安装 Node.js 和 NPM。

git clone https://github.com/kilkelly/nano-currency-mcp-server.git
cd nano-currency-mcp-server
npm install

你需要一个 MCP 客户端来连接 Nano Currency MCP Server。每个客户端连接 MCP 服务的方式都不相同。你需要查明所选客户端如何为 MCP 服务设置环境变量。了解设置方法后，需设置以下环境变量才能使用 Nano Currency MCP Server。

⚙️ 环境变量

NANO_RPC_URL（必需）——用于与 Nano 节点 RPC 通信的 URL。可以是本地或远程托管的端点。

NANO_WORK_GENERATION_URL——用于与支持 work_generate RPC 命令的端点通信，以生成工作量的 URL。若未指定，则默认为 NANO_RPC_URL。供工具 🔧 nano_send 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create 使用

NANO_PRIVATE_KEY——用于签署发送交易并派生 Nano 账户的 Nano 私钥。注意：🚨不是钱包种子🚨。请使用余额较少的账户私钥进行测试。供工具 🔧 nano_send 🔧 raw_send 🔧 nano_my_account_info 🔧 x402_payment_signature_exact_scheme_create 使用

RAW_MAX_SEND_AMOUNT——单笔交易可发送的最大金额（以 raw 为单位）。出于安全考虑，默认最大发送金额为 10000000000000000000000000000 raw（Ӿ0.01）。必须显式设置此变量，才能授予发送更高金额的权限。供工具 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create 使用

NANO_MAX_SEND_AMOUNT——单笔交易可发送的最大金额（以 nano 为单位）。出于安全考虑，默认最大发送金额为 0.01 nano（Ӿ0.01）。必须显式设置此变量，才能授予发送更高金额的权限。供工具 🔧 nano_send 🔧 x402_payment_signature_exact_scheme_create 使用

X402_NANO_NETWORK——创建 x402 Nano 交易时所使用的 Nano 网络。默认网络为 "nano:mainnet"。供工具 🔧 x402_payment_signature_exact_scheme_create 使用

设置示例

以下是 Claude Desktop 中 Nano Currency MCP Server 的设置示例。

{
  "mcpServers": {
    "nano_currency": {
      "command": "ENTER FULL FILE PATH TO node.exe ON YOUR SYSTEM",
      "args": [
        "ENTER FULL FILE PATH TO nano-currency.js FILE FROM THIS REPOSITORY"
      ],
      "env": {
        "NANO_RPC_URL": "ENTER YOUR NANO_RPC_URL",
        "NANO_WORK_GENERATION_URL": "ENTER YOUR NANO_WORK_GENERATION_URL",
        "NANO_PRIVATE_KEY": "ENTER YOUR NANO_PRIVATE_KEY",
        "RAW_MAX_SEND_AMOUNT": "ENTER A RAW_MAX_SEND_AMOUNT (in raw units, example 10000000000000000000000000000)",
        "NANO_MAX_SEND_AMOUNT": "ENTER A NANO_MAX_SEND_AMOUNT (in nano units, example 0.001, 1.000)",
        "X402_NANO_NETWORK": "ENTER YOUR X402_NANO_NETWORK"
      }      
    }    
  }
}

🚨 免责声明 🚨

与处理现实世界中的价值（此处为 Nano）时一样，使用本软件时请务必谨慎。对于任何因有意或无意使用本软件功能而导致的非预期资金损失，作者和贡献者概不负责。

📄 许可证

MIT