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)

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto de modelo que permite a los agentes de IA interactuar con la cadena de bloques Flow a través de llamadas RPC, lo que respalda los saldos de cuentas, la ejecución de scripts, las transacciones, la resolución de dominios y las interacciones de contratos.

Related MCP Servers

EVM MCP Server
mcpdotdirect
A
security
A
license
A
quality
A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
Last updated -
28
230
252
TypeScript
MIT License
Flow MCP Server
lmcmz
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
Last updated -
JavaScript
TON Access MCP Server
aiopinions
-
security
A
license
-
quality
A production-ready Model Context Protocol server implementation that connects AI assistants to the TON blockchain, allowing them to query wallet balances, transaction details, smart contracts, and other blockchain data.
Last updated -
TypeScript
MIT License
Starknet MCP Server
mcpdotdirect
A
security
A
license
A
quality
A comprehensive Model Context Protocol server that enables AI agents to interact with Starknet blockchain, query data, manage wallets, and work with smart contracts.
Last updated -
25
15
4
TypeScript
MIT License

View all related MCP servers

Flow MCP Server