Flow MCP Server

Flow MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,专门用于与 Flow 区块链进行直接 RPC 通信。它提供了多种工具和功能,使开发者能够轻松地与 Flow 区块链进行交互,包括获取账户余额、执行脚本、发送交易等。此外,它还支持 AI 代理集成,适用于需要与 Flow 区块链交互的各种场景。

  • by Outblock
  • 更新于
在 GitHub 查看 Outblock/flow-mcp-server

使用说明

基本能力

产品定位

Flow MCP Server 是一个专门用于与 Flow 区块链交互的 MCP 服务器,提供直接 RPC 通信和多种区块链操作工具。

核心功能

  • 获取账户余额(FLOW 和代币)
  • 执行 Flow 脚本
  • 发送交易
  • 解析域名到 Flow 地址
  • 与 Flow 合约交互
  • 完全兼容 MCP,支持 AI 代理集成

适用场景

  • 区块链开发
  • 智能合约交互
  • 账户余额查询
  • 域名解析
  • AI 代理与区块链的集成

工具列表

  • get_flow_balance:获取 FLOW 余额
  • get_token_balance:获取代币余额
  • execute_script:执行 Cadence 脚本
  • send_transaction:发送签名交易
  • resolve_domain:解析域名到 Flow 地址

常见问题解答

  • 默认使用 Flow 主网,可通过环境变量配置为测试网
  • 支持通过 npx 直接运行,无需安装
  • 提供 HTTP API 和 stdio 模式两种集成方式

使用教程

使用依赖

  1. 克隆仓库:
    git clone https://github.com/lmcmz/flow-mcp-server.git
    cd flow-mcp-server
    
  2. 安装依赖:
    # 使用 npm
    npm install
    
    # 使用 Bun(推荐)
    bun install
    

安装教程

  1. 可选:创建 .env 文件配置环境变量:
    PORT=3000
    FLOW_NETWORK=testnet  # 可选:默认为 'mainnet'
    
  2. 启动服务器:
    # 开发模式(热重载)
    bun dev
    
    # 生产模式
    bun start
    
    # 构建服务器
    bun run build
    

调试方式

  1. 使用 npx 直接运行:
    npx flow-mcp-server
    
    # 指定网络和端口
    npx flow-mcp-server --network testnet --port 3001
    
    # 查看帮助
    npx flow-mcp-server --help
    
  2. 或全局安装后运行:
    npm install -g flow-mcp-server
    flow-mcp-server