Servidor MCP de flujo

Name: Flow MCP Server
Author: lmcmz

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la blockchain de Flow. Este servidor permite a los asistentes de IA acceder a los datos de la blockchain de Flow y realizar operaciones a través de una interfaz estandarizada.

Características

Comprobación de saldo para Flow y tokens fungibles
Resolución de dominios .find y .fn
Ejecución de script para leer datos de blockchain
Envío y seguimiento de transacciones
Recuperación de información de la cuenta
Configuración de flujo basada en variables de entorno

Related MCP server: n8n MCP Server

Instalación

Uso de npx (recomendado)

npx -y @outblock/flow-mcp-server --stdio

O especifique el modo HTTP con un puerto:

npx -y @outblock/flow-mcp-server --port 3000

Instalación local (para desarrollo)

git clone https://github.com/lmcmz/flow-mcp-server.git cd flow-mcp-server npm install npm run build npm start

Uso

Ejecutando con npx

# Run in stdio mode (for AI assistant integration) npx -y @outblock/flow-mcp-server --stdio # Run as HTTP server on port 3000 npx -y @outblock/flow-mcp-server --port 3000 # Specify Flow network npx -y @outblock/flow-mcp-server --port 3000 --network testnet

Ejecución del servidor de desarrollo local

# Run in stdio mode npm run build npm start # Run as HTTP server on port 3000 npm run build PORT=3000 npm start # For development with auto-reload npm run dev

Configuración

El servidor se puede configurar mediante variables de entorno:

PORT - Puerto HTTP para escuchar (si no se configura, el modo predeterminado es stdio)
FLOW_NETWORK - Red de flujo a la que conectarse (red principal, red de prueba, emulador)
FLOW_ACCESS_NODE - URL de nodo de acceso de flujo personalizado
LOG_LEVEL - Nivel de registro (depuración, información, advertencia, error)

Uso con asistentes de IA

Al integrarse con asistentes de IA como Claude, puede iniciar el servidor MCP en modo stdio y conectarlo a la configuración de herramientas de su asistente.

Ejemplo de configuración de la herramienta Claude:

{ "tools": [ { "name": "flow-mcp-server", "command": "npx -y @outblock/flow-mcp-server --stdio" } ] }

Puntos finales de la API HTTP

Cuando se ejecuta en modo HTTP, están disponibles los siguientes puntos finales:

/sse - Punto final de eventos enviados por el servidor para actualizaciones en tiempo real
/messages - Punto final POST para enviar solicitudes de herramientas
/health - Punto final de verificación de estado
/ - Información del servidor

Ejemplo de llamada a la API HTTP:

curl -X POST http://localhost:3000/messages \ -H "Content-Type: application/json" \ -d '{ "tool_request": { "name": "get_balance", "parameters": { "address": "0x2d4c3caffbeab845", "network": "mainnet" } } }'

Herramientas disponibles

get_balance - Obtener el saldo de flujo para una dirección
get_token_balance - Obtener el saldo del token fungible
get_account - Obtener información de la cuenta
resolve_domain - Resolver un dominio .find o .fn a una dirección
execute_script - Ejecutar un script de Cadence
send_transaction - Envía una transacción a la cadena de bloques
get_transaction - Obtener detalles de la transacción por ID

Historial de versiones

v0.1.1 - Corrección de errores en la importación de formatArguments en el servicio de transacciones
v0.1.0 - Versión inicial con integración básica de blockchain de Flow