Nano Currency MCP server

The Nano Currency MCP Server enables MCP-compatible clients, including AI agents, to interact with Nano cryptocurrency by sending transactions and retrieving account information via the Nano node RPC. This server integrates with the Model Context Protocol (MCP) framework to give AI systems controlled access to Nano currency operations.

Prerequisites

Before installation, ensure you have Node.js with NPM installed on your system.

Installation

To install the Nano Currency MCP Server:

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

Configuration

Environment Variables

You'll need to configure the following environment variables:

• NANO_RPC_URL (required): URL for communication with a Nano node RPC (local or remote endpoint)
• NANO_WORK_GENERATION_URL: URL for work generation. Defaults to NANO_RPC_URL if not specified
• NANO_PRIVATE_KEY: Nano private key used for transaction signing and address derivation (NOT the wallet seed)
• NANO_MAX_SEND_AMOUNT: Maximum amount (in nano/Ӿ) for a single transaction. Default is 0.01 nano

Setting Up with Claude Desktop

1. Install Claude Desktop

Download and install Claude Desktop

2. Configure Claude for MCP

1. Open Claude Desktop
2. Access the Settings menu
3. Click the Developer tab, then Edit Config
4. Edit the claude_desktop_config.json file with your configuration:

{
  "mcpServers": {
    "nano_currency": {
      "command": "ENTER_FULL_FILE_PATH_TO_NODE_DOT_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",
        "NANO_MAX_SEND_AMOUNT": "ENTER_A_NEW_MAX_SEND_AMOUNT"
      }      
    }    
  }
}

Configuration notes:

• For Windows paths, use double backslashes (e.g., C:\\Program Files\\nodejs\\node.exe)
• If your work generation URL is the same as your RPC URL, you can omit the NANO_WORK_GENERATION_URL line
• Use a private key from an account with a small Nano balance for testing
• Consider keeping the maximum send amount low during testing

3. Using the MCP Tools

After configuring and restarting Claude Desktop, you'll have access to these tools:

• nano_send: Sends a specified amount of Nano currency
• nano_account_info: Retrieves information about a specific Nano account/address
• nano_my_account_info: Retrieves information about your predefined Nano account
• block_info: Retrieves information about a specific Nano block

Security Considerations

• Always test with small amounts of Nano first
• Be aware that AI models may not always perform as expected
• Consider the security implications of storing your private key in configuration files
• Set reasonable limits with the NANO_MAX_SEND_AMOUNT parameter

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.