Lmcmz Flow MCP Server

🚀 流量 MCP 服務器

流量 MCP 服務器是一個用於與 Flow 區塊鏈交互的模型上下文協議 (MCP) 服務器。它允許 AI 助手通過標準化接口訪問 Flow 區塊鏈數據並執行操作，為區塊鏈數據的獲取和操作提供了便捷途徑。

🚀 快速開始

你可以按照以下步驟快速啟動流量 MCP 服務器，與 Flow 區塊鏈進行交互。

✨ 主要特性

• 🔍 檢查 Flow 和可替代代幣餘額
• 🌐 解決 .find 和 .fn 域名的解析問題
• 📖 執行腳本來讀取區塊鏈數據
• 📄 提交和監控交易
• 👤 獲取賬戶信息
• ⚙️ 根據環境變量配置 Flow 網絡

📦 安裝指南

使用 npx（推薦）

使用 npx 可以快速安裝並運行流量 MCP 服務器，以下是不同模式的啟動命令：

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 導入問題。