Servidor MCP de flujo

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: EVM 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

Licencia

Instituto Tecnológico de Massachusetts (MIT)