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：初始版本發佈