Servidor MCP de flujo

Servidor de Protocolo de Contexto de Modelo (MCP) para la cadena de bloques Flow con comunicación RPC directa.

Este servidor implementa el Protocolo de Contexto de Modelo y proporciona herramientas para interactuar con la cadena de bloques Flow directamente a través de llamadas RPC.

Características

Obtener saldos de cuentas (FLOW y tokens)
Ejecutar scripts de flujo
Enviar transacciones
Resolver dominios en direcciones de flujo
Interactuar con los contratos de Flow
Cumplimiento total de MCP para la integración de agentes de IA

Configuración

Clonar el repositorio:
git clone https://github.com/lmcmz/flow-mcp-server.git cd flow-mcp-server
Instalar dependencias:
# Using npm npm install # Using Bun (recommended) bun install
(Opcional) Cree un archivo .env con su configuración:
PORT=3000 FLOW_NETWORK=testnet # Optional: defaults to 'mainnet' if not specified
El servidor usa automáticamente la red principal de Flow por defecto. Solo necesitas configurar el entorno si quieres usar la red de prueba o un puerto personalizado.

Uso

Iniciando el servidor

# Run in development mode with hot reload
bun dev

# Run in production mode
bun start

# Build the server
bun run build

Uso del comando NPX

Puede ejecutar el servidor MCP directamente usando npx sin instalación:

# Run using npx
npx flow-mcp-server

# Specify network and port
npx flow-mcp-server --network testnet --port 3001

# Get help for all options
npx flow-mcp-server --help

O instálelo globalmente:

# Install globally
npm install -g flow-mcp-server

# Run the globally installed version
flow-mcp-server

Opciones de línea de comandos

Options:
  -p, --port <port>          Port to run the server on (default: 3000)
  -n, --network <network>    Flow network to connect to (default: mainnet)
  -a, --access-node <url>    Custom Flow access node URL
  --stdio                    Run in stdio mode for direct integration
  -h, --help                 Show this help text

Configuración de red

El servidor configura automáticamente FCL con las direcciones de contrato adecuadas para la red seleccionada. Se admiten las siguientes redes:

Red principal

La configuración de la red principal incluye direcciones de contrato para:

{
  NonFungibleToken: '0x1d7e57aa55817448',
  FungibleToken: '0xf233dcee88fe0abe',
  MetadataViews: '0x1d7e57aa55817448',
  NFTCatalog: '0x49a7cda3a1eecc29',
  NFTRetrieval: '0x49a7cda3a1eecc29',
  Find: '0x097bafa4e0b48eef',
  Flowns: '0x233eb012d34b0070',
  Domains: '0x233eb012d34b0070',
  FlowToken: '0x1654653399040a61',
  TransactionGeneration: '0xe52522745adf5c34',
  FlowFees: '0xf919ee77447b7497',
  StringUtils: '0xa340dc0a4ec828ab',
  HybridCustody: '0xd8a7e05a7ac670c0',
  ViewResolver: '0x1d7e57aa55817448'
}

Red de prueba

La configuración de la red de prueba incluye direcciones de contrato para el entorno de red de prueba.

También puede ver la configuración de red actual accediendo al punto final /networks .

Configuración de MCP

Para configurar un asistente de IA para que utilice Flow MCP, utilice la siguiente configuración:

{
  "mcpServers": {
    "flow-mcp": {
      "command": "npx",
      "args": ["-y", "flow-mcp-server", "--stdio"],
      "env": {
        "FLOW_NETWORK": "mainnet"  // Optional: defaults to 'mainnet', can be set to 'testnet'
      }
    }
  }
}

O con API HTTP directa:

{
  "mcpServers": {
    "flow-mcp": {
      "serverUrl": "http://localhost:3000",
      "env": {
        "FLOW_NETWORK": "mainnet"
      }
    }
  }
}

Uso con asistentes de IA

El servidor implementa el Protocolo de Contexto de Modelo, lo que permite su uso con asistentes de IA compatibles con MCP. Expone diversas herramientas para interactuar con la blockchain de Flow.

Puntos finales de API

/sse - Punto final SSE para comunicación en tiempo real
/messages - Punto final para enviar solicitudes de herramientas
/health - Punto final de verificación de estado
/ - Información del servidor
/networks - Información de configuración de red

Herramientas disponibles

get_flow_balance - Obtener el saldo de FLOW para una dirección
get_token_balance - Obtener el saldo del token para una dirección
execute_script - Ejecutar un script de Cadence
send_transaction - Envía una transacción firmada a la cadena de bloques Flow
resolve_domain - Resolver un dominio .find o .fn en una dirección de flujo

Publicación en npm

Si desea publicar su propia versión de este paquete:

# Login to npm
npm login

# Publish the package
npm publish

# Update the package
npm version patch  # or minor or major
npm publish

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Flow MCP Server

Integrations