流量 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 运行

# 在 stdio 模式下运行（适用于 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

运行本地开发服务器

# 在 stdio 模式下运行
npm run build
npm start

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

# 开发时使用自动重载功能
npm run dev

配置

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

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

与 AI 助手集成

当将服务器与 AI 助手（如 Claude）集成时，可以启动 stdio 模式的 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 - 获取账户信息
• execute_transaction - 提交和监控交易
• resolve_domain - 解决 .find 和 .fn 域名

版本历史

• 1.0.0 - 初始版本发布。
• 1.1.0 - 修复了事务服务中 formatArguments 导入问题。