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 (

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

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.

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

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

Tools

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
564
819
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 -
15
660
100
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 -
3
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
132
14
MIT License

View all related MCP servers

Neo N3 MCP Server

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

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

Herramientas disponibles

Configuración y red

Información de blockchain

Gestión de billeteras y cuentas

Transferencias de activos

Interacción de contratos inteligentes

NeoFS (Almacenamiento descentralizado)

NeoBurger (Servicio de staking)

Solicitudes de ejemplo

Obtenga información sobre blockchain

Transferir activos

Manejo de errores

Mejores prácticas de seguridad

Servidor HTTP

Puntos finales HTTP

Ejemplo de solicitudes HTTP

Beneficios del servidor HTTP

Pruebas

Ejecución de pruebas

Recursos

Licencia

Tools

Related MCP Servers

Notion MCP Server

Salesforce MCP Server

Ledger MCP Server

Salesforce MCP Server

Appeared in Searches

New MCP Servers

MCP directory API