MCP 服务器

Nano Currency MCP Server

使用模型上下文协议 (MCP) 启用 AI 代理，以通过 Nano 节点 RPC 发送 Nano 加密货币并检索帐户/区块信息。

README

Nano 货币 MCP 服务器

此模型上下文协议 (MCP) 服务器使兼容 MCP 的客户端（包括一些 AI 代理）能够通过 Nano 节点 RPC 发送 Nano 货币并检索帐户和区块信息。

AI 代理越来越多地采用 MCP 标准，因此该服务器可以让他们能够根据所有者的请求发送 Nano，或者在某些设置中可能自主发送 🤖

❔ 什么是 MCP？

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

❔ 什么是 Nano 货币？

Nano 是一种数字货币，旨在实现快速、可扩展且无手续费的交易。它旨在解决传统加密货币中的常见问题，例如高额费用和缓慢的处理时间，使其成为日常点对点支付的有效选择。在 nano.org 了解更多信息

🚨 前提条件 🚨

注意：LLM 可能会产生幻觉，并且不总是按照您想要的方式执行，因此请使用少量 Nano 测试此服务器。

🛠️ MCP 服务器提供的工具

🔧 nano_send - 发送指定数量的 Nano 货币

🔧 nano_account_info - 检索有关特定 Nano 帐户/地址的详细信息

🔧 nano_my_account_info - 检索有关您预定义的 Nano 帐户/地址的详细信息

🔧 block_info - 检索有关特定 Nano 区块的详细信息

先决条件

确保您已安装带有 NPM 的 Node.js。

安装

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

您将需要一个 MCP 客户端来连接到 MCP 服务器（请参阅后面的 Claude Desktop 设置作为 MCP 客户端的示例）。每个客户端都有自己的连接到 MCP 服务器的方式。对于您选择的客户端，您必须找出如何设置 MCP 服务器的环境变量。当您知道如何操作时，您将需要设置以下环境变量才能使用 Nano 货币 MCP 服务器。

环境变量

NANO_RPC_URL - 用于与 Nano 节点 RPC 通信的 URL。这可以是本地或远程托管的端点。此 URL 值是必需的。

NANO_WORK_GENERATION_URL - 用于与支持 work_generate RPC 命令进行工作量生成的端点通信的 URL。如果未指定，则默认为 NANO_RPC_URL。由工具 🔧 nano_send 使用

NANO_PRIVATE_KEY - Nano 私钥，将用于签署发送交易并从中派生 Nano 地址。注意：🚨不是钱包种子🚨。使用具有少量 Nano 余额的帐户的私钥进行测试。由工具 🔧 nano_send 和 🔧 nano_my_account_info 使用

NANO_MAX_SEND_AMOUNT - 单笔交易中可以发送的最大金额（以 nano/Ӿ 为单位）。出于安全目的，默认最大发送金额为 0.01 nano (Ӿ0.01)。您必须显式设置此变量才能授予发送更高金额的权限。由工具使用：🔧 nano_send

Claude Desktop 设置

1. 安装并运行 Claude Desktop

2. 打开“设置”菜单

3. 单击“开发者”选项卡，然后单击“编辑配置”按钮以打开 Claude 配置文件 `claude_desktop_config.json` 的位置

4. 在您选择的文本编辑器中打开 `claude_desktop_config.json` 并输入以下内容，但将值替换为您唯一的配置：

{
  "mcpServers": {
    "nano_currency": {
      "command": "输入您系统上 NODE_DOT_EXE 的完整文件路径",
      "args": [
        "输入来自此存储库的 NANO_CURRENCY_JS_FILE 的完整文件路径"
      ],
      "env": {
        "NANO_RPC_URL": "输入您的 NANO_RPC_URL",
        "NANO_WORK_GENERATION_URL": "输入您的 NANO_WORK_GENERATION_URL",
        "NANO_PRIVATE_KEY": "输入您的 NANO_PRIVATE_KEY",
        "NANO_MAX_SEND_AMOUNT": "输入新的最大发送金额"
      }      
    }    
  }
}

笔记：

ENTER_FULL_FILE_PATH_TO_NODE_DOT_EXE_ON_YOUR_SYSTEM 应该指向您的 Node.js 安装中的 node.exe 可执行文件，例如 C:\\Program Files\\nodejs\\node.exe
ENTER_FULL_FILE_PATH_TO_NANO_CURRENCY_JS_FILE_FROM_THIS_REPOSITORY 应该指向此存储库中的 nano-currency.js 文件，例如 C:\\projects\\nano-currency-mcp-server\\nano-currency.js
如果您使用的是 Windows，则需要在文件路径中使用双反斜杠，例如 C:\\Program Files\\nodejs\\node.exe
ENTER_YOUR_NANO_RPC_URL 和 ENTER_YOUR_NANO_WORK_GENERATION_URL 通常可能是相同的值，在这种情况下，只需完全省略 NANO_WORK_GENERATION_URL 行即可。 ENTER_YOUR_NANO_RPC_URL 的示例可能类似于 http://localhost:7076
ENTER_YOUR_NANO_PRIVATE_KEY - 这不是 🚨钱包种子🚨，而是您控制的 Nano 地址的私钥。此密钥用于签署 Nano 交易并从中派生您的 Nano 地址。请使用包含少量 Nano 的地址的私钥进行测试。
ENTER_A_NEW_MAX_SEND_AMOUNT 是可选的，但如果您想覆盖默认的发送最大值 0.01 nano (Ӿ0.01)，则可以使用它。仅输入一个数值（不带“nano”或“Ӿ”）。建议在测试时不要设置此值或将其设置得低于默认值，因为它会阻止发送高于预期的 Nano 金额，因为 LLM 可能会产生幻觉。