Flow MCP 服务器

具有直接 RPC 通信功能的 Flow 区块链的模型上下文协议 (MCP) 服务器。

该服务器实现了模型上下文协议，并提供了通过 RPC 调用直接与 Flow 区块链交互的工具。

特征

获取账户余额（FLOW 和代币）
执行 Flow 脚本
发送交易
将域名解析为 Flow 地址
与 Flow 合约交互
完全符合 MCP 规范，可实现 AI 代理集成

设置

克隆存储库：
git clone https://github.com/lmcmz/flow-mcp-server.git cd flow-mcp-server
安装依赖项：
# Using npm npm install # Using Bun (recommended) bun install
（可选）使用您的配置创建一个.env文件：
PORT=3000 FLOW_NETWORK=testnet # Optional: defaults to 'mainnet' if not specified
服务器默认使用 Flow 主网。如果您想使用测试网或自定义端口，只需配置环境即可。

用法

启动服务器

# Run in development mode with hot reload
bun dev

# Run in production mode
bun start

# Build the server
bun run build

使用 NPX 命令

您可以直接使用 npx 运行 MCP 服务器，无需安装：

# Run using npx
npx flow-mcp-server

# Specify network and port
npx flow-mcp-server --network testnet --port 3001

# Get help for all options
npx flow-mcp-server --help

或者全局安装：

# Install globally
npm install -g flow-mcp-server

# Run the globally installed version
flow-mcp-server

命令行选项

Options:
  -p, --port <port>          Port to run the server on (default: 3000)
  -n, --network <network>    Flow network to connect to (default: mainnet)
  -a, --access-node <url>    Custom Flow access node URL
  --stdio                    Run in stdio mode for direct integration
  -h, --help                 Show this help text

网络配置

服务器会自动为 FCL 配置所选网络的相应合约地址。支持以下网络：

主网

主网配置包括以下合约地址：

{
  NonFungibleToken: '0x1d7e57aa55817448',
  FungibleToken: '0xf233dcee88fe0abe',
  MetadataViews: '0x1d7e57aa55817448',
  NFTCatalog: '0x49a7cda3a1eecc29',
  NFTRetrieval: '0x49a7cda3a1eecc29',
  Find: '0x097bafa4e0b48eef',
  Flowns: '0x233eb012d34b0070',
  Domains: '0x233eb012d34b0070',
  FlowToken: '0x1654653399040a61',
  TransactionGeneration: '0xe52522745adf5c34',
  FlowFees: '0xf919ee77447b7497',
  StringUtils: '0xa340dc0a4ec828ab',
  HybridCustody: '0xd8a7e05a7ac670c0',
  ViewResolver: '0x1d7e57aa55817448'
}

测试网

测试网配置包括测试网环境的合约地址。

您还可以通过访问/networks端点查看当前网络配置。

MCP 配置

要配置 AI 助手使用 Flow MCP，请使用以下配置：

{
  "mcpServers": {
    "flow-mcp": {
      "command": "npx",
      "args": ["-y", "flow-mcp-server", "--stdio"],
      "env": {
        "FLOW_NETWORK": "mainnet"  // Optional: defaults to 'mainnet', can be set to 'testnet'
      }
    }
  }
}

或者直接使用 HTTP API：

{
  "mcpServers": {
    "flow-mcp": {
      "serverUrl": "http://localhost:3000",
      "env": {
        "FLOW_NETWORK": "mainnet"
      }
    }
  }
}

与人工智能助手一起使用

该服务器实现了模型上下文协议 (MCP)，使其能够与支持 MCP 的 AI 助手一起使用。它提供了各种与福洛区块链交互的工具。

API 端点

/sse用于实时通信的 SSE 端点
/messages - 发送工具请求的端点
/health - 健康检查端点
/ - 服务器信息
/networks网络配置信息

可用工具

get_flow_balance - 获取地址的 FLOW 余额
get_token_balance - 获取地址的代币余额
execute_script Cadence 脚本
send_transaction - 将签名的交易发送到 Flow 区块链
resolve_domain - 将 .find 或 .fn 域名解析为 Flow 地址

发布到 npm

如果您想发布此包的自己的版本：

# Login to npm
npm login

# Publish the package
npm publish

# Update the package
npm version patch  # or minor or major
npm publish

执照

麻省理工学院

Flow MCP Server

Integrations