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
用法
启动服务器
# 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
执照
麻省理工学院