Flow MCP Server

Flow MCP 服务

用于与 Flow 区块链交互的模型上下文协议（MCP）服务。此服务可让 AI 助手通过标准化接口访问 Flow 区块链数据并执行操作。

功能

• 查询 Flow 和同质化代币余额
• 解析 .find 和 .fn 域名
• 执行脚本以读取区块链数据
• 提交并监控交易
• 获取账户信息
• 根据环境变量配置 Flow

安装

使用 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 运行

# 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

运行本地开发服务

# 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

配置

可以使用环境变量配置此服务：

• PORT - 要监听的 HTTP 端口（若未设置，则默认为 stdio 模式）
• FLOW_NETWORK - 要连接的 Flow 网络（mainnet、testnet、emulator）
• FLOW_ACCESS_NODE - 自定义 Flow 访问节点 URL
• LOG_LEVEL - 日志级别（debug、info、warn、error）

与 AI 助手配合使用

将此 MCP 服务集成到 Claude 等 AI 助手时，可以在 stdio 模式下启动服务，并将其连接到助手的工具配置中。

Claude 工具配置示例：

{
  "tools": [
    {
      "name": "flow-mcp-server",
      "command": "npx -y @outblock/flow-mcp-server --stdio"
    }
  ]
}

HTTP API 端点

在 HTTP 模式下运行时，可使用以下端点：

• /sse - 用于实时更新的服务器发送事件端点
• /messages - 用于发送工具请求的 POST 端点
• /health - 健康检查端点
• / - 服务信息

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"
      }
    }
  }'

可用工具

• get_balance - 获取某个地址的 Flow 余额
• get_token_balance - 获取同质化代币余额
• get_account - 获取账户信息
• resolve_domain - 将 .find 或 .fn 域名解析为地址
• execute_script - 执行 Cadence 脚本
• send_transaction - 向区块链发送交易
• get_transaction - 根据 ID 获取交易详情

版本历史

• v0.1.1 - 修复交易服务中导入 formatArguments 时出现的问题
• v0.1.0 - 首次发布，提供基本的 Flow 区块链集成

许可证

MIT