Zan MCP Server

🚀 ZAN MCP Server

A server implementation based on the Model Context Protocol (MCP), designed specifically for ZAN.top blockchain node services. It offers various tools and interfaces to facilitate blockchain interaction, enabling AI assistants to seamlessly access and process blockchain data via the MCP protocol.

🚀 Quick Start

ZAN MCP Server is a server implementation based on the Model Context Protocol specification, tailored for ZAN.top blockchain node services. It provides a variety of tools and service interfaces, supporting functions such as blockchain information query and address resolution. This allows AI assistants to easily access and process blockchain data through the MCP protocol.

✨ Features

• Multi-chain Support: Supports multiple blockchain networks.
• Rich Functionality: Offers comprehensive blockchain operation interfaces.
• High Efficiency and Reliability: Optimized performance ensures stable operation.
• Easy Integration: Simple API design facilitates project integration.

📦 Supported Blockchains

ZAN MCP Server currently supports the following blockchain networks:

EVM Chains

• Ethereum
• Binance Smart Chain
• Polygon Network

Other Chains

• Solana
• TRON
• Cosmos SDK Chains

💻 Usage Examples

::: warning Please refer to the original link for image examples. :::

📚 Documentation

ZAN MCP Server provides a rich set of API interfaces to facilitate blockchain interaction for developers. The interfaces are categorized as follows:

Resources

• Blockchain Information Query: Retrieve basic chain information, node status, etc.
• Transaction Query: Search for detailed information of specific transactions.
• Address Balance Query: Check the asset balance of a specified address.

Service Tools

EVM Tools

// Example code
const { createEvmService } = require('zan-mcp-server');

const evmService = createEvmService({
  chainId: '0x1', // Ethereum mainnet
  privateKey: 'your-private-key'
});

// Get balance
async function getBalance(address) {
  return await evmService.getBalance(address);
}

Solana Tools

const { createSolanaService } = require('zan-mcp-server');

const solanaService = createSolanaService({
  endpoint: 'https://api.mainnet-beta.solana.com',
  privateKey: 'your-base58-private-key'
});

// Send transaction
async function sendTransaction(from, to, amount) {
  return await solanaService.sendTx(from, to, amount);
}

📦 Configuration Examples

Configuration in Claude Desktop

Add the following content to the config.json file:

{
  "mcpServers": {
    "zan": {
      "command": "npx",
      "args": [
        "-y",
        "zan-mcp-server",
        "--stdio",
        "--api-key",
        "<your_api_key>"
      ]
    }
  }
}

Configuration in Cursor

Add a server.json file to the project root directory:

{
  "mcpServers": {
    "zan": {
      "command": "npx",
      "args": [
        "zan-mcp-server",
        "--stdio",
        "--api-key",
        "<your_api_key>"
      ]
    }
  }
}

Configuration in VSCode

Add the following content to settings.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "zan_api_key",
      "description": "ZAN node service API key",
      "password": false
    }
  ],
  "servers": {
    "zan": {
      "command": "npx",
      "args": [
        "zan-mcp-server",
        "--stdio",
        "--api-key",
        "${input:zan_api_key}"
      ]
    }
  }
}

⚠️ Important Note

For functions that require write operations (such as sending transactions and signing messages), you need to provide the private key of the corresponding chain:

• For EVM chains: --evm-private-key <private-key>
• For Solana: --solana-private-key <base58-private-key>

Project Integration

import { createStdioServer } from 'zan-mcp-server';

// Create and start the server
const server = createStdioServer({
  // Configuration options
});

// Handle server lifecycle events

🔧 Technical Details

# Install dependencies
pnpm install

# Development mode
pnpm dev:watch

# Build the project
pnpm build

# Test using the MCP inspection tool
pnpm inspect

📄 License

MIT License written by Jeason