Servidor MCP Neo N3

Protocolo de contexto del modelo Neo N3 (MCP) v1.4.0

El Protocolo de Contexto de Modelo (MCP) de Neo N3 proporciona una interfaz estandarizada para que los agentes y aplicaciones de IA interactúen con la blockchain de Neo N3. Esta implementación de servidor busca la simplicidad y facilidad de uso, ejecutándose directamente a través de npx sin necesidad de configuración manual del entorno para un uso estándar.

Agregar el MCP a un cliente (por ejemplo, VS Code)

Configure su cliente para utilizar el servidor de E/S estándar a través de npx :

Opción A: Configuración de usuario de VS Code (JSON)

Agregue lo siguiente a su JSON de configuración de usuario ( Ctrl+Shift+P > Preferences: Open User Settings (JSON) ):

{
  "mcp": {
    "servers": {
      "neo-n3": { // You can choose any name
        "command": "npx",
        "args": [
          "-y", // Auto-confirm npx installation/update
          "@r3e/neo-n3-mcp"
        ]
      }
    }
  }
}

Opción B: Configuración del espacio de trabajo ( .vscode/mcp.json )

Crea un archivo llamado mcp.json dentro del directorio .vscode :

{
  "servers": {
    "neo-n3": { // You can choose any name
      "command": "npx",
      "args": [
        "-y", // Auto-confirm npx installation/update
        "@r3e/neo-n3-mcp"
      ]
    }
  }
}

Opción C: Otros clientes (por ejemplo, Cursor)

Siga las instrucciones de su cliente para agregar un servidor MCP mediante un comando. Proporcione el comando npx y los argumentos ["-y", "@r3e/neo-n3-mcp"] .

Herramientas disponibles

Para obtener parámetros y ejemplos detallados, consulte la documentación de API.md.

Configuración y red

Herramienta	Descripción	Parámetros clave
`get_network_mode`	Obtener el modo de red configurado actualmente	Ninguno
`set_network_mode`	Establecer el modo de red activo para llamadas posteriores	`mode` : "solo red principal", "solo red de prueba" o "ambos"

Información de blockchain

Herramienta	Descripción	Parámetros clave
`get_blockchain_info`	Obtenga la altura actual y la información general de la red	`network`
`get_block_count`	Obtener la altura actual del bloque	`network`
`get_block`	Obtener detalles del bloque por hash o altura	`network` , `hashOrHeight`
`get_transaction`	Obtener detalles de la transacción por ID de transacción	`network` , `txid`
`check_transaction_status`	Comprobar si una transacción está confirmada	`network` , `txid`

Gestión de billeteras y cuentas

Herramienta	Descripción	Parámetros clave
`create_wallet`	Crear un nuevo archivo de billetera encriptado	`password`
`import_wallet`	Importar billetera existente desde WIF/clave privada	`key` , `password`
`get_balance`	Obtener saldos de tokens para una dirección	`network` , `address`

Transferencias de activos

Herramienta	Descripción	Parámetros clave
`transfer_assets`	Envíe tokens NEO, GAS u otros NEP-17	`network` , `fromWIF` , `toAddress` , `asset` , `amount` , `confirm`
`estimate_transfer_fees`	Calcule las tarifas de red y sistema para una transferencia	`network` , `fromAddress` , `toAddress` , `asset` , `amount`

Interacción de contratos inteligentes

Herramienta	Descripción	Parámetros clave
`list_famous_contracts`	Enumere los contratos conocidos compatibles con el servidor	`network`
`get_contract_info`	Obtener detalles (hash, métodos) de un contrato famoso	`network` , `contractName`
`invoke_contract` (reemplaza invocar_lectura/escritura)	Invocar un método de contrato inteligente (lectura o escritura)	`network` , `scriptHash` , `operation` , `args` , `fromWIF` (para escribir), `confirm` (para escribir)

NeoFS (Almacenamiento descentralizado)

Herramienta	Descripción	Parámetros clave
`neofs_create_container`	Crear un contenedor de almacenamiento NeoFS	`network` , `fromWIF` , `ownerId` , `rules` , `confirm`
`neofs_get_containers`	Lista de contenedores propiedad de un ID	`network` , `ownerId`

NeoBurger (Servicio de staking)

Herramienta	Descripción	Parámetros clave
`neoburger_deposit`	Deposite NEO para recibir bNEO	`network` , `fromWIF` , `confirm`
`neoburger_withdraw`	Retirar NEO devolviendo bNEO	`network` , `fromWIF` , `amount` , `confirm`

Solicitudes de ejemplo

Obtenga información sobre blockchain

Pedido:

{
  "name": "get_blockchain_info",
  "arguments": {
    "network": "mainnet"
  }
}

Respuesta:

{
  "result": {
    "height": 3456789,
    "network": "mainnet"
  }
}

Transferir activos

Pedido:

{
  "name": "transfer_assets",
  "arguments": {
    "network": "testnet",
    "fromWIF": "YourSenderWalletWIF",
    "toAddress": "NZNos2WqTbu5oCgyfss9kUJgBXJqhuYAaj",
    "asset": "NEO",
    "amount": "1",
    "confirm": true
  }
}

Respuesta:

{
  "result": {
    "txid": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "address": "NVbGwMfRQVudQCcChhCFwQRwSxr5tYEqQs",
    "network": "testnet"
  }
}

Manejo de errores

El servidor MCP devuelve respuestas de error estandarizadas:

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid network parameter. Must be 'mainnet' or 'testnet'."
  }
}

Códigos de error comunes:

INVALID_PARAMETER : parámetro faltante o no válido
NETWORK_ERROR : Error al conectarse al nodo Neo N3
BLOCKCHAIN_ERROR : Error de la cadena de bloques Neo N3
WALLET_ERROR : Error con las operaciones de la billetera
CONTRACT_ERROR : Error con las operaciones del contrato inteligente
UNAUTHORIZED : Operación no permitida
INTERNAL_ERROR : Error inesperado del servidor

Mejores prácticas de seguridad

Manejo de WIF: Tenga mucho cuidado al proporcionar claves de Formato de Importación de Monedero (WIF). Asegúrese de que el entorno donde se ejecuta el servidor MCP y el canal de comunicación sean seguros. Considere ejecutar el servidor localmente o dentro de una red confiable. Evite exponer el servidor públicamente sin una autenticación robusta y seguridad de transporte (HTTPS).
Almacene los archivos de billetera de forma segura si utiliza enfoques basados en archivos (aunque la API actual parece estar basada en WIF).
Utilice confirm: true para todas las operaciones de cambio de estado (transferencias, invocaciones de contrato) para garantizar que la red procese la transacción.
Almacene los archivos de su billetera de forma segura con contraseñas seguras
Utilice testnet para desarrollo y pruebas
Mantenga su servidor Neo N3 MCP actualizado a la última versión

Servidor HTTP

Además del servidor MCP, este paquete también proporciona un servidor HTTP que expone la funcionalidad de Neo N3 mediante una API RESTful. El servidor HTTP se inicia automáticamente al ejecutar el servidor MCP y escucha en el puerto 3002 de forma predeterminada.

Puntos finales HTTP

Punto final	Método	Descripción
`/api/blockchain/info`	CONSEGUIR	Obtenga información sobre blockchain
`/api/blockchain/height`	CONSEGUIR	Obtener la altura actual del bloque
`/api/blocks/:height`	CONSEGUIR	Obtener detalles del bloque por altura
`/api/transactions/:txid`	CONSEGUIR	Obtener detalles de la transacción por ID de transacción
`/api/accounts/:address/balance`	CONSEGUIR	Obtener saldos de tokens para una dirección
`/api/wallets`	CORREO	Crear una nueva billetera
`/api/wallets/:address`	CONSEGUIR	Obtener información de la billetera
`/api/wallets/import`	CORREO	Importar una billetera desde WIF o clave privada
`/api/network/mode`	CONSEGUIR	Obtener el modo de red actual
`/api/contracts/:name/invoke`	CORREO	Invocar un método de contrato inteligente
`/api/contracts/deploy`	CORREO	Implementar un nuevo contrato inteligente

Ejemplo de solicitudes HTTP

# Get blockchain information
curl http://localhost:3002/api/blockchain/info

# Get the current block height
curl http://localhost:3002/api/blockchain/height

# Get token balances for an address
curl http://localhost:3002/api/accounts/NZNos2WqTbu5oCgyfss9kUJgBXJqhuYAaj/balance

# Create a new wallet
curl -X POST -H "Content-Type: application/json" -d '{"password":"your-password"}' http://localhost:3002/api/wallets

# Get the current network mode
curl http://localhost:3002/api/network/mode

# Deploy a smart contract
curl -X POST -H "Content-Type: application/json" -d '{
  "wif": "your-private-key-wif",
  "script": "base64-encoded-contract-script",
  "manifest": {
    "name": "MyContract",
    "groups": [],
    "features": {},
    "abi": {
      "methods": [
        {
          "name": "myMethod",
          "parameters": [],
          "returnType": "Boolean",
          "offset": 0
        }
      ],
      "events": []
    },
    "permissions": [
      {
        "contract": "*",
        "methods": "*"
      }
    ],
    "trusts": [],
    "supportedStandards": []
  }
}' http://localhost:3002/api/contracts/deploy

Beneficios del servidor HTTP

Accesibilidad : proporciona acceso a la funcionalidad de la cadena de bloques Neo N3 para aplicaciones que no admiten el protocolo MCP
Simplicidad : API RESTful simple que se puede utilizar con cualquier cliente HTTP
Compatibilidad : funciona con aplicaciones y marcos web existentes
Pruebas : más fácil de probar y depurar que el protocolo MCP

Pruebas

Este paquete incluye pruebas de integración para verificar la funcionalidad tanto del servidor MCP como del servidor HTTP.

Ejecución de pruebas

# Build the project
npm run build

# Run the core functionality tests
npm run test:core

# Run the HTTP integration tests
npm run test:http

# Run the MCP integration tests
npm run test:integration

Recursos

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor MCP que proporciona una integración perfecta con la cadena de bloques Neo N3, lo que permite a Claude interactuar con los datos de la cadena de bloques, administrar billeteras, transferir activos e invocar contratos inteligentes.

Related MCP Servers

Notion MCP Server
suekou
A
security
A
license
A
quality
MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
1,398
699
TypeScript
MIT License
Salesforce MCP Server
tsmztech
A
security
A
license
A
quality
An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
Last updated -
7
180
45
TypeScript
MIT License
Ledger MCP Server
mprokopov
-
security
A
license
-
quality
An MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.
Last updated -
1
Python
GPL 3.0
Salesforce MCP Server
SurajAdsul
A
security
A
license
A
quality
An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
Last updated -
7
18
4
TypeScript
MIT License

View all related MCP servers

Neo N3 MCP Server