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

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)

Flow MCP Server

Integrations