Flow MCP サーバー
直接 RPC 通信を備えた Flow ブロックチェーン用のモデル コンテキスト プロトコル (MCP) サーバー。
このサーバーはモデルコンテキストプロトコルを実装し、RPC 呼び出しを通じて Flow ブロックチェーンと直接対話するためのツールを提供します。
特徴
- アカウント残高（FLOWとトークン）を取得する
- フロースクリプトを実行する
- トランザクションを送信する
- ドメインをフローアドレスに解決する
- フロー契約と対話する
- AIエージェント統合のための完全なMCP準拠
設定
- リポジトリをクローンします。
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構成
Flow MCP を使用するように AI アシスタントを構成するには、次の構成を使用します。
{
"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"
}
}
}
}
AIアシスタントとの使用
サーバーはモデルコンテキストプロトコル（MCP）を実装しており、MCPをサポートするAIアシスタントで使用できます。Flowブロックチェーンとやり取りするための様々なツールを公開しています。
APIエンドポイント
/sse - リアルタイム通信用のSSEエンドポイント/messages - ツールリクエストを送信するためのエンドポイント/health - ヘルスチェックエンドポイント/ - サーバー情報/networks - ネットワーク構成情報
利用可能なツール
get_flow_balance - アドレスのFLOW残高を取得するget_token_balance - アドレスのトークン残高を取得するexecute_script - Cadenceスクリプトを実行するsend_transaction - 署名されたトランザクションをFlowブロックチェーンに送信するresolve_domain - .find または .fn ドメインをフローアドレスに解決します
npmへの公開
このパッケージの独自のバージョンを公開したい場合は、次の手順に従ってください。
# Login to npm
npm login
# Publish the package
npm publish
# Update the package
npm version patch # or minor or major
npm publish
ライセンス
マサチューセッツ工科大学