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
サーバーはデフォルトで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構成

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

ライセンス

マサチューセッツ工科大学

Flow MCP Server

Integrations