Factor MCP

🚀 Factor MCP Server

AIツールがEVMチェーン上のFactor Protocolヴォールトとやり取りできるようにするMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• 完全なヴォールト管理のための 68のMCPツール
• マルチチェーン対応：Arbitrum One、Base、Ethereum Mainnet
• 安全なウォレット管理：Foundry Keystore（Web3 V3）+ AES-256-GCM暗号化
• シミュレーションモード：トランザクションを実行する前にプレビューできます
• ストラテジー構築：ビルディングブロックを使用してDeFiストラテジーを構築できます
• Foundry統合：フォークシミュレーション、エラーデコード、forgeスクリプト

🚀 クイックスタート

ワンラインインストール

curl -sSL https://raw.githubusercontent.com/FactorDAO/factor-mcp/main/install.sh | bash

これにより以下が行われます：

• Rustがインストールされていない場合はインストールします
• Foundry（cast、anvil、forge）をインストールします
• Factor MCPをクローンしてビルドします
• factor-mcpコマンドを作成します

手動インストール

git clone https://github.com/FactorDAO/factor-mcp.git
cd factor-mcp
npm install
npm run build

設定

サーバーは~/.factor-mcp/config.jsonに保存されたJSON設定を使用します：

{
  "alchemyApiKey": "your_api_key",
  "defaultChain": "ARBITRUM_ONE",
  "simulationMode": false,
  "logLevel": "info",
  "activeWallet": "default"
}

環境変数はJSON設定を上書きできます：

• ALCHEMY_API_KEY - RPCアクセス用のAlchemy APIキー
• DEFAULT_CHAIN - デフォルトのチェーン（ARBITRUM_ONE、OPTIMISM、BASE、SONIC、MAINNET）
• SIMULATION_MODE - ドライランモードを有効にする場合は"true"に設定
• LOG_LEVEL - ログレベル（debug、info、warn、error）
• FACTOR_ARTIFACTS_DIR - 生成されたforgeスクリプトをこのディレクトリに保存します（Docker/エフェメラル環境で有用）

実行

# 直接実行
npm start

# または環境変数を使用して実行
ALCHEMY_API_KEY=xxx npm start

Claude Code統合

Claude Codeの設定（~/.config/claude-code/config.jsonまたはMCP設定）に追加します：

{
  "mcpServers": {
    "factor": {
      "command": "node",
      "args": ["/path/to/factor-mcp/dist/index.js"],
      "env": {
        "ALCHEMY_API_KEY": "your_api_key"
      }
    }
  }
}

💻 使用例

基本的な使用法

# ワンラインインストール
curl -sSL https://raw.githubusercontent.com/FactorDAO/factor-mcp/main/install.sh | bash

# 手動インストール
git clone https://github.com/FactorDAO/factor-mcp.git
cd factor-mcp
npm install
npm run build

# 設定
{
  "alchemyApiKey": "your_api_key",
  "defaultChain": "ARBITRUM_ONE",
  "simulationMode": false,
  "logLevel": "info",
  "activeWallet": "default"
}

# 実行
npm start

# Claude Code統合
{
  "mcpServers": {
    "factor": {
      "command": "node",
      "args": ["/path/to/factor-mcp/dist/index.js"],
      "env": {
        "ALCHEMY_API_KEY": "your_api_key"
      }
    }
  }
}

📚 詳細ドキュメント

ツールリファレンス

設定（5つのツール）

ヴォールト操作（14のツール）

ヴォールト管理（12のツール）

貸付操作（4つのツール）

スワップ操作（4つのツール）

LP操作（4つのツール）

収益操作（1つのツール）

フラッシュローン（1つのツール）

トークンとレジストリ（3つのツール）

ストラテジー構築（1つのツール）

トランザクションツール（2つのツール）

プロファイルとストラテジー（6つのツール）

Foundryツール（5つのツール）

🔧 技術詳細

ウォレットストレージ

ウォレットは2つのバックエンドをサポートしています：

• Factor-MCP（デフォルト）：~/.factor-mcp/wallets/ — AES-256-GCM暗号化、PBKDF2キー導出（100,000回の反復）
• Foundry Keystore：~/.foundry/keystores/ — Web3 Secret Storage V3形式、cast/gethと互換性があります

ベストプラクティス

1. 本番環境のウォレットには常に暗号化を使用してください
2. テストにはシミュレーションモードを使用してください (simulationMode: true)
3. ウォレットファイルやAPIキーをコミットしないでください

📦 インストール

Dockerデプロイ

# イメージをビルド
docker build -t factor-mcp .

# docker-composeで実行
docker-compose up -d

開発

# 依存関係をインストール
npm install

# 型チェック
npm run typecheck

# ビルド
npm run build

# 開発モードで実行
npm run dev

# テストを実行
npm test

📚 SDKカバレッジロードマップ

このロードマップは、MCPサーバーが@factordao/sdk-studioパッケージをカバーする状況を追跡します。[x]でマークされた項目はMCPで実装されており、[ ]でマークされた項目はまだ公開されていないSDK機能です。

設定とウォレット

• [x] アクティブなチェーンを設定する（ARBITRUM_ONE、BASE、MAINNET）
• [x] カスタムRPCエンドポイントを設定する
• [x] 現在の設定（チェーン、RPC、ウォレット、シミュレーションモード）を取得する
• [x] 秘密鍵からウォレットをインポートする
• [x] 新しいランダムなウォレットを生成する
• [x] Foundry Keystoreストレージ（Web3 V3形式）
• [x] Factor-MCP暗号化ストレージ（AES-256-GCM）
• [x] 既存のFoundryキーストアを使用する
• [x] SDKアドレス帳（Proアダプターアドレス）を取得する

ヴォールトの作成とテンプレート

• [x] 新しいFactor Proヴォールトをデプロイする (factor_create_vault)
• [x] すぐに使えるパラメータを持つヴォールトテンプレート (factor_vault_templates)
• [x] 貸付可能なヴォールトテンプレート（Aaveプリセット）
• [x] 貸付可能なヴォールトテンプレート（Compound V3プリセット）
• [x] 貸付可能なヴォールトテンプレート（Morphoプリセット）
• [x] ファクトリから会計アダプターを自動検出する
• [x] デプロイ前にヴォールト設定を検証する (factor_validate_vault_config)
• [x] ホワイトリストされたファクトリアドレスを取得する (factor_get_factory_addresses)
• [x] 不変のヴォールトオプション
• [x] 設定可能な手数料、上限、債務比率、クールダウン、アップグレード可能性

ヴォールトクエリ

• [x] 所有するヴォールトを取得する (factor_get_owned_vaults)
• [x] ヴォールト情報（資産、手数料、マネージャー、アダプター）を取得する (factor_get_vault_info)
• [x] ユーザーのシェア、総供給量、シェアあたりの価格を取得する (factor_get_shares)
• [x] デコードされた呼び出しを含む実行履歴を取得する (factor_get_executions)
• [x] 預け入れのプレビュー（予想されるシェア） (factor_preview_deposit)
• [x] 引き出しのプレビュー（予想される資産） (factor_preview_withdraw)
• [ ] 資産が有効な預け入れ資産であるかチェックする (isDepositAsset)
• [ ] 資産が有効な引き出し資産であるかチェックする (isWithdrawAsset)
• [ ] 資産の会計アダプターを取得する (getAssetAccounting)
• [ ] 債務の会計アダプターを取得する (getDebtAccounting)
• [ ] 生の引き出し予想額を推定する (estimateRawWithdrawExpectedAmount)
• [ ] Alchemyを介したUSD残高の内訳を取得する (balanceUsd)

ヴォールトの預け入れと引き出し

• [x] ERC20トークンを預け入れる (factor_deposit)
• [x] シェアを引き出す/償還する (factor_withdraw)
• [ ] ネイティブトークン（ETH）を預け入れる (depositNative)
• [ ] 預け入れとストラテジーを1つのトランザクションで実行する (depositAssetAndExecute)
• [ ] 実行ブロックを伴う生の引き出し (rawWithdraw)

ヴォールトの手数料管理

• [x] 預け入れ手数料を設定する (factor_set_deposit_fee)
• [x] 引き出し手数料を設定する (factor_set_withdraw_fee)
• [x] パフォーマンス手数料を設定する (factor_set_performance_fee)
• [x] 管理手数料を設定する (factor_set_management_fee)
• [x] 累積パフォーマンス手数料を請求する (factor_charge_performance_fee)
• [x] 手数料受取人を設定する (factor_set_fee_receiver)

ヴォールトのリスクとアクセス管理

• [x] 最大預け入れ上限を設定する (factor_set_max_cap)
• [x] 最大債務比率を設定する (factor_set_max_debt_ratio)
• [x] 価格偏差許容範囲を設定する (factor_set_price_deviation_allowance)
• [x] ヴォールトマネージャーを追加する (factor_add_vault_manager)
• [x] ヴォールトマネージャーを削除する (factor_remove_vault_manager)
• [x] リスクマネージャーを設定する (factor_set_risk_manager)

ヴォールトのストラテジー設定

• [ ] 公開ストラテジーを設定する (setPublicStrategy)
• [ ] 公開ストラテジーを削除する (removePublicStrategy)
• [ ] 公開ストラテジーを実行する (executePublicStrategy)
• [ ] 預け入れストラテジーを設定する (setDepositStrategy)
• [ ] 預け入れストラテジーを削除する (removeDepositStrategy)

ヴォールトのシミュレーション

• [ ] 預け入れをシミュレートする (simulateDeposit)
• [ ] パフォーマンス手数料の請求をシミュレートする (simulateChargePerformanceFee)

トークンと承認

• [x] ERC20トークンの承認 (factor_give_approval)
• [x] 貸付トークン（aTokens、債務トークン、基盤資産）を取得する (factor_get_lending_tokens)
• [x] 資産/債務トークンをヴォールトに追加する (factor_add_vault_token)
• [ ] ERC2612パーミット/ガスレス承認 (permitアダプター)

貸付 — Aave V3

• [x] 供給/全量供給/パーセンテージで供給
• [x] 引き出し/全量引き出し
• [x] 借入れ
• [x] 返済/全量返済

貸付 — Compound V3

• [x] 供給/全量供給
• [x] 引き出し/全量引き出し
• [x] 借入れ
• [x] 返済/全量返済
• [ ] 報酬を請求する (claimRewards)

貸付 — Morpho

• [x] 供給（貸付）
• [x] 担保として供給
• [x] 引き出し（貸付 + 担保）
• [x] 借入れ
• [x] 返済/全量返済

貸付 — Silo V2

• [x] 供給
• [x] 引き出し
• [x] 借入れ
• [x] 返済

DEX — Uniswap V3

• [x] 正確な入力単一スワップ (factor_swap)
• [x] 全残高をスワップ
• [x] パーセンテージでスワップ
• [x] 設定可能な手数料レベル（100、500、3000、10000）
• [x] 設定可能なスリッページ
• [x] 正確な出力単一スワップ (factor_swap_exact_output)
• [x] 全残高で正確な出力単一スワップ (factor_swap_exact_outputでamountInMax "all")

DEX — OpenOcean

• [x] 集約スワップ (factor_swap_openocean)

DEX — Pendle PT/YT

• [x] トークンをPTにスワップ
• [x] トークンをYTにスワップ
• [x] PTをトークンにスワップ
• [x] YTをトークンにスワップ

DEX — Aqua

• [ ] Aqua DEXスワップ（Base）

LP — Uniswap V3

• [x] 集中流動性ポジションを作成する
• [x] 既存のポジションに流動性を追加する
• [x] 流動性を削除する（金額または"all"）
• [x] 蓄積された手数料を収集する
• [ ] パーセンテージで流動性を削除する (removeByPercentage)

LP — Camelot V3

• [x] 集中流動性ポジションを作成する
• [x] 流動性を追加する
• [x] 流動性を削除する
• [x] 手数料を収集する
• [ ] パーセンテージで流動性を削除する (removeByPercentage)

LP — Aerodrome

• [x] 集中流動性ポジションを作成する
• [x] 流動性を追加する
• [x] 流動性を削除する
• [x] 手数料を収集する

収益 — Pendle LP

• [x] Pendle市場に流動性を追加する
• [x] 流動性を削除する
• [x] 手数料/報酬を収集する

フラッシュローン

• [x] 内部ストラテジーステップを伴うAaveフラッシュローン
• [x] 内部ストラテジーステップを伴うMorphoフラッシュローン
• [ ] Balancerフラッシュローン (balancerFL)

ストラテジービルダー

• [x] executeByManagerを介してストラテジーを実行する
• [x] 利用可能なアダプターをリストする (factor_list_adapters)
• [x] ストラテジーをStats APIに保存する (factor_save_strategy)
• [x] ストラテジーをStats APIから削除する (factor_delete_strategy)
• [x] ハッシュでストラテジーを取得する (factor_get_strategy)
• [x] 所有者によるストラテジーを取得する (factor_get_strategies)
• [x] プロファイルをStats APIに保存する (factor_save_profile)
• [x] プロファイルをStats APIから取得する (factor_get_profile)
• [ ] ストラテジーをコールデータとしてエクスポートする (export)
• [ ] ストラテジーをJSONとしてエクスポートする (exportToJson)
• [ ] ストラテジーをクローンする (clone)
• [ ] ストラテジーをステップごとにデバッグする (debugFromBlocks)
• [ ] ユーザーの影響を推定する (estimate / estimateFromBlocks)
• [ ] ストラテジーの概要を取得する (summary)
• [ ] トークンの状態変化を推測する (guessTokenState)

ユーティリティアダプター

• [ ] アドレス間でトークンを転送する (transferアダプター)
• [ ] 微小な金額を返金する (refundアダプター)
• [ ] ネイティブトークンのラップ/アンラップ (nativeアダプター)
• [ ] ERC721 / NFT操作 (erc721アダプター)
• [ ] レバレッジヴォールト操作 (leverageVaultアダプター)
• [ ] レバレッジストラテジー構築 (leverageStrategyアダプター)
• [ ] 預け入れポリシー管理 (depositPolicyアダプター)
• [ ] Gelato自動化設定 (gelatoアダプター)
• [ ] Chainlink直接価格フィードクエリ (chainlinkアダプター)

アダプターの発見とメタデータ

• [x] チェーンごとにアダプターをリストする (factor_list_adapters)
• [ ] アダプター全体のユーザーポートフォリオ情報を取得する (getUserInfo)
• [ ] ビルディングブロック/プロトコルのマーケットを取得する (getMarkets)
• [ ] 入力トークンによるマーケットを取得する (getMarketByInToken)
• [ ] 入力トークンによるプロトコルを取得する (getProtocolsByInToken)
• [ ] サポートされている入力トークンを取得する (getInTokens)
• [ ] アダプターのメタデータを取得する (getMetadata / getMetadataByBuildingBlock)
• [ ] すべてのビルディングブロックタイプを取得する (getBuildingBlocks)

ブーストシステム

• [ ] ブーストホワイトリストにトークンを追加する (addBoostTokenWhitelist)
• [ ] ブーストホワイトリストからトークンを削除する (removeBoostTokenWhitelist)
• [ ] ヴォールト報酬を預け入れる (depositRewardForVaultBN)
• [ ] ブースト報酬を償還する (redeemBoostRewards)
• [ ] すべてのブースト報酬を償還する (redeemBoostRewardAll)
• [ ] ブースト報酬トークンを取得する (getBoostRewardTokens)
• [ ] ユーザーによる獲得済みブーストトークンを取得する (boostEarnedTokensByUser)
• [ ] 報酬データを取得する (rewardData)
• [ ] 期間ごとの報酬を取得する (getRewardForDuration)

スケールシステム

• [ ] スケールヴォールトを取得する (getVaults)
• [ ] スケールヴォールトの詳細を取得する (getVaultDetail)
• [ ] ユーザーのスケールポジションを取得する (getUserVaults)
• [ ] ユーザーのアクティブな残高を取得する (activeBalance)
• [ ] 総アクティブ供給量を取得する (totalActiveSupply)
• [ ] スケール報酬トークンを取得する (getScaleRewardTokens)
• [ ] スケール報酬を償還する (redeemScaleRewards)
• [ ] ブースト + スケール報酬をまとめて償還する (redeemBoostAndScaleRewards)
• [ ] ゲージに投票する (vote)
• [ ] 投票を取り消す (unvote)
• [ ] ユーザー/ヴォールトの投票を取得する
• [ ] スケール報酬を請求する (claimRewards)
• [ ] スケールマーケットデータを取得する (getMarketData)
• [ ] 履歴データを取得する (getHistoricalData)

賄賂システム

• [ ] 賄賂を作成する (addBribe)
• [ ] 賄賂を請求する (claimBribe)
• [ ] 賄賂情報を取得する (getBribe)
• [ ] すべての賄賂を取得する (getAllBribes)

トランザクションとデバッグ

• [x] ガス推定を伴うトランザクションのプレビュー (factor_preview_transaction)
• [x] トランザクションのステータスを確認する (factor_get_transaction_status)
• [x] Foundryのインストールを確認する (factor_check_foundry)
• [x] castを介した読み取り専用のコントラクト呼び出し (factor_cast_call)
• [x] anvilを介したフォークネットワークでのシミュレーション (factor_simulate_transaction)
• [x] コントラクトエラーをデコードする (factor_decode_error)
• [x] Solidity forgeスクリプトを実行する (factor_run_forge_script)
• [x] シミュレーションのための残高オーバーライド
• [x] 自動生成されたForgeスクリプトを伴うシミュレーションヒント

Proアダプターの利用可能性

MCPサーバーでは_proアダプターのみが使用されます。デプロイされていないアダプターはロードマップから除外されます。

貸付

DEX

LP

収益

フラッシュローン

会計

インフラストラクチャ

注: Ethereum MainnetにはProアダプターがデプロイされていません（テストではファクトリ + Chainlink会計のみ）。

カバレッジの概要

📄 ライセンス

MIT