Flow Blockchain

🚀 流量 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 で実行する

# 標準入出力モード（AI アシスタントとの統合に適しています）
npx -y @outblock/flow-mcp-server --stdio

# HTTP サーバーモードで実行し、デフォルトのポート 3000 を使用する
npx -y @outblock/flow-mcp-server --port 3000

# Flow ネットワーク環境を指定する
npx -y @outblock/flow-mcp-server --port 3000 --network testnet

ローカル開発サーバーで実行する

# 標準入出力モード
npm run build
npm start

# ポートを指定して HTTP サーバーモードで実行する
npm run build
PORT=3000 npm start

# 開発環境での自動再読み込み機能
npm run dev

📚 ドキュメント

設定オプション

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

AI アシスタントとの統合

AI アシスタント（Claude など）と統合する場合は、MCP サーバーを標準入出力モードで起動し、アシスタントのツール設定に接続します。 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 - ブロックチェーンデータを読み取るスクリプトを実行する
• submit_transaction - トランザクションを送信し、状態を監視する

バージョン履歴

• 1.0.0：初期バージョンのリリース