MCP 服务器

Flow MCP Server

镜子 (jìng zi)

MCP-Mirror

开发者工具

访问服务器

README

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

# 在 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 助手一起使用

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

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