Flow Blockchain

🚀 流量 MCP 服务器

流量 MCP 服务器是一个用于与 Flow 区块链交互的 Model Context Protocol (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 运行

# 标准输入输出模式（适用于 AI 助手集成）
npx -y @outblock/flow-mcp-server --stdio

# 以 HTTP 服务器模式运行，默认端口 3000
npx -y @outblock/flow-mcp-server --port 3000

# 指定 Flow 网络环境
npx -y @outblock/flow-mcp-server --port 3000 --network testnet

本地开发服务器运行

# 标准输入输出模式
npm run build
npm start

# 指定端口以 HTTP 服务器模式运行
npm run build
PORT=3000 npm start

# 开发环境下自动重载功能
npm run dev

高级用法

配置选项

服务器可通过环境变量进行配置：

与 AI 助手集成

当与 AI 助手（如 Claude）集成时，可通过启动 MCP 服务器的标准输入输出模式，并将其连接到助手的工具配置中。 示例 Claude 工具配置：

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

HTTP API 端点

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

• /sse - 实时更新的 Server-Sent Events（服务器发送事件）端点
• /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 - 执行区块链数据读取脚本
• submit_transaction - 提交交易并监控状态

📚 详细文档

版本历史

• 1.0.0：初始版本发布