Flow MCP Server

Flow MCP サーバー

Flow ブロックチェーンと連携するための Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、AI アシスタントは標準化されたインターフェースを通じて Flow ブロックチェーンのデータにアクセスし、操作を実行できます。

機能

• Flow および代替性トークンの残高確認
• .find および .fn ドメインの解決
• ブロックチェーンデータを読み取るためのスクリプト実行
• トランザクションの送信と監視
• アカウント情報の取得
• 環境変数に基づく Flow の設定

インストール

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 ネットワーク（mainnet、testnet、emulator）
• FLOW_ACCESS_NODE - カスタム Flow アクセスノードの URL
• LOG_LEVEL - ログレベル（debug、info、warn、error）

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 - アドレスの Flow 残高を取得
• 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 ブロックチェーンの基本的な連携機能を備えた初回リリース

ライセンス

MIT