Flow MCP Server

基本能力

产品定位

Flow MCP Server 是一个用于与 Flow 区块链交互的中间件，为 AI 助手提供标准化的区块链数据访问和操作接口。

核心功能

• 查询 Flow 和可替代代币的余额
• 解析 .find 和 .fn 域名
• 执行脚本读取区块链数据
• 提交和监控交易
• 检索账户信息
• 基于环境变量的 Flow 配置

适用场景

• AI 助手集成区块链功能
• 区块链数据查询服务
• 区块链交易监控系统
• 去中心化域名解析服务

工具列表

• get_balance: 获取地址的 Flow 余额
• get_token_balance: 获取可替代代币余额
• get_account: 获取账户信息
• resolve_domain: 解析域名到地址
• execute_script: 执行 Cadence 脚本
• send_transaction: 向区块链发送交易
• get_transaction: 通过 ID 获取交易详情

常见问题解答

• 如何切换网络？通过 --network 参数或 FLOW_NETWORK 环境变量
• 如何运行 HTTP 服务器？使用 --port 参数
• 如何集成到 AI 助手？使用 stdio 模式并配置工具

使用教程

使用依赖

需要安装 Node.js 和 npm

安装教程

使用 npx (推荐)

npx -y @outblock/flow-mcp-server --stdio

或指定 HTTP 模式:

npx -y @outblock/flow-mcp-server --port 3000

本地安装 (开发用)

git clone https://github.com/lmcmz/flow-mcp-server.git
cd flow-mcp-server
npm install
npm run build
npm start

调试方式

运行 npx

# stdio 模式
npx -y @outblock/flow-mcp-server --stdio

# HTTP 服务器模式
npx -y @outblock/flow-mcp-server --port 3000 --network testnet

运行本地开发服务器

# stdio 模式
npm run build
npm start

# HTTP 服务器模式
npm run build
PORT=3000 npm start

# 开发模式 (自动重载)
npm run dev

HTTP API 测试

curl -X POST http://localhost:3000/messages \
  -H "Content-Type: application/json" \
  -d '{
    "tool_request": {
      "name": "get_balance",
      "parameters": {
        "address": "0x2d4c3caffbeab845",
        "network": "mainnet"
      }
    }
  }'

许可证

该项目遵循 MIT 开源许可条款。