Nano Currency MCP Server

Nano 通貨 MCP サーバー

Nano Currency MCP Server を使うと、MCP 互換クライアント（AI エージェントを含む）は Nano ノード RPC を介して Nano 通貨を送信したり、アカウントやブロックの情報を取得したりできます。

AI エージェントは MCP 標準をますます採用しており、このサーバーを使うと、所有者の要求に応じて、または一部の設定では自律的に Nano を送信できます 🤖

Nano Currency MCP Server では、x402 互換ヘッダーも作成できます。これにより、AI エージェントは Nano を使って API やリソースの料金を支払えます。

❔ MCP とは？

Model Context Protocol（MCP）は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供するための標準的な方法を定めたオープンフレームワークです。

❔ Nano 通貨とは？

Nano は、高速でスケーラブル、かつ手数料無料の取引を実現するために設計されたデジタル通貨です。高い手数料や処理の遅さなど、従来の暗号資産にありがちな問題の解決を目指しており、日常的なピアツーピア決済に適した効率的な選択肢です。詳しくは nano.org をご覧ください。

❔ x402 とは？

x402 は、未使用の HTTP 402 Payment Required ステータスコードを活用し、ウェブ上で即時かつプログラム可能で、許可不要の決済を可能にするインターネットネイティブな決済プロトコルです。詳しくは x402.org をご覧ください。Nano 固有の x402 スキームと実装コードは、x402nano GitHub リソース にあります。

🚨 続行する前に 🚨

注意：LLM は幻覚を起こすことがあり、常に意図どおりに動作するとは限らないため、少額の Nano でこのサーバーをテストしてください。一度に送信できる Nano の最大額を制限するには、後述する RAW_MAX_SEND_AMOUNT または NANO_MAX_SEND_AMOUNT 環境変数を使用してください。

🛠️ Nano Currency MCP Server が提供するツール

🔧 raw_send - 事前に設定した Nano アカウントから宛先の Nano アカウントへ、指定した量の raw 単位を送信します。

🔧 nano_send - 事前に設定した Nano アカウントから宛先の Nano アカウントへ、指定した量の nano 単位を送信します。

🔧 nano_account_info - 残高（nano 単位と raw 単位の両方）、代表者、フロンティアブロックなど、指定した Nano アカウントの詳細情報を取得します。

🔧 nano_my_account_info - 残高（nano 単位と raw 単位の両方）、代表者、フロンティアブロックなど、自分の Nano アカウントの詳細情報を取得します。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

Nano Currency MCP Server に接続するには、MCP クライアントが必要です。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 残高が少ないアカウントの秘密鍵でテストしてください。ツール 🔧 nano_send 🔧 raw_send 🔧 nano_my_account_info 🔧 x402_payment_signature_exact_scheme_create で使用されます。

RAW_MAX_SEND_AMOUNT - 1 回のトランザクションで送信できる最大額（raw 単位）です。安全のため、デフォルトの最大送信額は 10000000000000000000000000000 raw（Ӿ0.01）です。これより高額の送信を許可するには、この変数を明示的に設定する必要があります。ツール 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create で使用されます。

NANO_MAX_SEND_AMOUNT - 1 回のトランザクションで送信できる最大額（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