MCP Blockchain Server
Servidor blockchain y DApp MCP
Un sistema seguro que permite a los asistentes de IA interactuar con contratos inteligentes de blockchain y al mismo tiempo garantizar que los usuarios mantengan un control total sobre sus claves privadas y la firma de transacciones.
Descripción general
Este proyecto aborda un desafío clave en la integración de IA y blockchain: permitir que los asistentes de IA lean datos de blockchain y preparen transacciones mientras se garantiza que los usuarios mantengan control exclusivo sobre la firma de transacciones y las claves privadas.
El sistema consta de:
Servidor MCP : un servidor de protocolo de contexto de modelo que expone las operaciones de blockchain como herramientas que pueden ser utilizadas por asistentes de IA
Web DApp : una aplicación React que proporciona una interfaz de usuario para la conexión de billetera y la firma de transacciones.
Base de datos : base de datos PostgreSQL para almacenar usuarios, claves API y registros de transacciones
Almacenamiento en caché : Redis para almacenar en caché datos a los que se accede con frecuencia
Related MCP server: keygenix-mcp
Características
Características del servidor MCP
Acceso a datos de blockchain : lectura de saldos, estado de contratos y otros datos en cadena
Preparación de transacciones : crear transacciones sin firmar para la aprobación del usuario
Compatibilidad con múltiples cadenas : funciona con Ethereum, Polygon y otras cadenas compatibles con EVM
Interacción de contratos inteligentes : lea contratos inteligentes verificados en redes compatibles
Diseño que prioriza la seguridad : las claves privadas nunca salen de la billetera del usuario
Características de la aplicación web DApp
Integración de billetera : conéctese con MetaMask y otras billeteras Web3
Revisión de transacciones : interfaz de usuario clara para revisar los detalles de la transacción antes de firmar
Firma de transacciones : Firme transacciones con la billetera conectada
Seguimiento de transacciones : supervise el estado de las transacciones enviadas
Compatibilidad móvil : el diseño adaptable funciona en todos los dispositivos.
Principios de seguridad
Aislamiento de clave privada : las claves nunca salen de la billetera del usuario
Verificación de transacciones : interfaz de usuario clara para revisar los detalles de la transacción
Autenticación de API : gestión segura de claves API
Limitación de velocidad : evitar el abuso
Validación de entrada : desinfectar todas las entradas
Registro de auditoría : seguimiento de todas las operaciones
Sólo HTTPS : Comunicaciones seguras
Política de seguridad de contenido : Prevenir XSS
Flujo de transacciones
El asistente de IA solicita transacciones a través del servidor MCP
El servidor MCP prepara una transacción sin firmar con UUID
El servidor MCP devuelve la URL de la transacción al asistente de IA
El asistente de IA proporciona la URL al usuario
El usuario abre la URL en el navegador
El usuario conecta la billetera y revisa los detalles de la transacción.
El usuario aprueba y firma la transacción con su billetera
La aplicación web DApp envía la transacción firmada a la cadena de bloques
El estado de la transacción se actualiza y se rastrea.
Empezando
Prerrequisitos
Node.js (v18 o superior)
npm o hilo
PostgreSQL
Redis (opcional, para almacenamiento en caché)
Clave API de Infura (para acceso a blockchain)
Clave API de Etherscan (para ABI de contrato)
Instalación
Clonar el repositorio:
git clone https://github.com/zhangzhongnan928/mcp-blockchain-server.git
cd mcp-blockchain-serverInstalar dependencias:
npm install
# or
yarn installConfigurar variables de entorno: Cree un archivo
.enven el directorio raíz (o cópielo desde.env.example):
cp .env.example .env
# Edit .env with your configurationsConfigurar la base de datos:
# For detailed instructions, see the Database Setup Guide
# docs/database-setup.md
# Create the PostgreSQL database
createdb mcp_blockchain
# Run database migrations
npm run db:migrate
# or
yarn db:migrateConsulte la Guía de configuración de la base de datos para obtener instrucciones detalladas sobre la instalación y configuración de PostgreSQL.
Iniciar el servidor:
npm run dev
# or
yarn devUso de Docker Compose
Para comenzar rápidamente a utilizar Docker:
# Create .env file with required environment variables
cp .env.example .env
# Edit .env with your configurations
# Start the services
docker-compose up -dEsto comenzará:
Base de datos PostgreSQL
Caché de Redis
Servidor MCP
Aplicación web descentralizada
Desarrollo
Estructura del servidor
src/mcp: Implementación del servidor MCPsrc/services: Servicios de lógica empresarial básicasrc/utils: Funciones de utilidadsrc/index.ts: Punto de entrada principal
Estructura de la aplicación web DApp
web/src/components: Componentes de Reactweb/src/hooks: Ganchos de React personalizadosweb/src/services: Servicios APIweb/src/pages: Componentes de la página
Uso del servidor MCP
El servidor MCP expone varias herramientas que pueden utilizar los asistentes de IA:
get-chains: Obtener la lista de redes blockchain compatiblesget-balance: Obtener el saldo de la cuenta de una direcciónread-contract: Leer datos de un contrato inteligenteprepare-transaction: prepara una transacción sin firmar para la aprobación del usuarioget-transaction-status: obtener el estado actual de una transacción
Ejemplo de uso de la herramienta
// Example of using the get-balance tool
const result = await callTool("get-balance", {
chainId: "1",
address: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
});Solución de problemas
Si encuentra problemas con las dependencias:
# MCP SDK issue - install directly from GitHub
npm uninstall @modelcontextprotocol/sdk
npm install modelcontextprotocol/typescript-sdkPara problemas de conexión a la base de datos, consulte la Guía de configuración de la base de datos .
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Available Tools
5 toolsget-balanceGet native balanceARead-only
Get an address's native-token balance (e.g. ETH) on a given chain.
Inputs: address (required), chainId (required).
get-chainsList supported chainsARead-only
List the blockchain networks this server supports, with their chain ids and native currencies.
Inputs: no named parameters.
get-transaction-statusGet transaction statusARead-only
Check the current status of a prepared transaction by its id.
Inputs: id (required).
prepare-transactionPrepare a transaction for signingA
Create an unsigned transaction and return a URL the user opens to review and sign it in their own wallet. Private keys never reach this server. Share the returned URL with the user.
Inputs: to (required), chainId (required), data, value, +1 more.
read-contractRead a smart contractARead-only
Call a read-only (view/pure) contract method. Provide abi as human-readable signatures (e.g. ["function balanceOf(address) view returns (uint256)"]) for zero-config use, or set ETHERSCAN_API_KEY to auto-fetch verified ABIs.
Inputs: method (required), address (required), chainId (required), abi, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct blockchain operation: balance query, chain listing, transaction status, transaction preparation, and contract reading. No functional overlap.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., get-balance, prepare-transaction). No mixing of styles.
With 5 tools, the server covers core blockchain interactions without being excessive or too sparse. Each tool serves a clear purpose.
The tool set covers essential operations: balance, chain info, contract reading, and transaction lifecycle. Missing features like event log retrieval or gas estimation, but for basic blockchain interactions it is largely complete.
Maintenance
Related MCP Connectors
Crypto wallet for AI agents: balances, payments, swaps and trading with owner controls.
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Security intelligence for AI agents monitoring Ethereum before actions.
Trusted execution infrastructure for AI agents. Proposal-only protocol with human consent.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to check balances and send transactions across multiple blockchains with automatic spending limit protection and policy enforcement.3MIT
- AlicenseBqualityNot gradedmaintenanceNon-custodial TEE key management and signing for AI agents, supporting multiple blockchains.12MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to analyze Ethereum wallets, simulate transactions, and draft transfers with deterministic policy and risk scoring, requiring human approval before on-chain execution.12 npmISC

Signo MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI assistants to monitor DeFi positions, draft Notify or Prepare agents, and manage agents on a user's account. Wallet owners retain control by reviewing and signing every draft before anything runs.MIT