Flow MCP サーバー

Flowブロックチェーンと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIアシスタントはFlowブロックチェーンのデータにアクセスし、標準化されたインターフェースを介して操作を実行できるようになります。

特徴

Flowと代替トークンの残高チェック
.findおよび.fnドメインのドメイン解決
ブロックチェーンデータを読み取るためのスクリプト実行
取引の提出と監視
アカウント情報の取得
環境変数に基づくフロー構成

インストール

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で実行

# Run in stdio mode (for AI assistant integration)
npx -y @outblock/flow-mcp-server --stdio

# Run as HTTP server on port 3000
npx -y @outblock/flow-mcp-server --port 3000

# Specify Flow network
npx -y @outblock/flow-mcp-server --port 3000 --network testnet

ローカル開発サーバーの実行

# Run in stdio mode
npm run build
npm start

# Run as HTTP server on port 3000
npm run build
PORT=3000 npm start

# For development with auto-reload
npm run dev

構成

サーバーは環境変数を使用して設定できます。

PORT - リッスンする HTTP ポート (設定されていない場合は、デフォルトで stdio モードになります)
FLOW_NETWORK - 接続するフローネットワーク（メインネット、テストネット、エミュレーター）
FLOW_ACCESS_NODE - カスタムフローアクセスノードURL
LOG_LEVEL - ログレベル（デバッグ、情報、警告、エラー）

AIアシスタントと併用する

Claude などの AI アシスタントと統合する場合は、MCP サーバーを stdio モードで起動し、アシスタントのツール構成に接続できます。

Claude ツールの構成例:

{
  "tools": [
    {
      "name": "flow-mcp-server",
      "command": "npx -y @outblock/flow-mcp-server --stdio"
    }
  ]
}

HTTP APIエンドポイント

HTTP モードで実行する場合、次のエンドポイントが利用できます。

/sse - リアルタイム更新のための Server-Sent Events エンドポイント
/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"
      }
    }
  }'

利用可能なツール

get_balance - アドレスのフロー残高を取得する
get_token_balance - 代替トークンの残高を取得する
get_account - アカウント情報を取得する
resolve_domain - .find または .fn ドメインをアドレスに解決する
execute_script - Cadenceスクリプトを実行する
send_transaction - ブロックチェーンにトランザクションを送信する
get_transaction - IDでトランザクションの詳細を取得する

バージョン履歴

v0.1.1 - トランザクションサービスにおける formatArguments インポートの問題のバグ修正
v0.1.0 - 基本的なFlowブロックチェーン統合を備えた初期リリース

ライセンス

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

Flow MCP Server

Integrations