Spectra MCP Server

🚀 MetaVault MCP

AIエージェント向けのマルチプロトコル収益インテリジェンスです。Model Context Protocolを介して、Spectra Finance、Pendle、Morphoをサポートしています。

50のツール · 3つのプロトコル · 10以上のチェーン · 読み取り専用 · オンチェーンのCurve見積もり · PendleのロジットAMMモデリング · ERC - 4626の健全性チェック · 収益カーブの期間構造 · 過去のeth_getLogs · 完全なPendleプロトコルの同等機能（13のツール） · クロスプロトコルのSpectra↔Pendle比較 · Morphoの供給側可視性 · Morphoのユーザーポジションと過去のレート · MerklキャンペーンのAPR統合 · キュレーターのリスク監視 · 引き出しのストレステスト · ロールオーバー計画 · マルチボールトポートフォリオの集約 · プールの満期監視 · Web3ライブラリの依存関係なし

🚀 クイックスタート

MCPをサポートする任意のAIエージェント（Claude、GPT、オープンソース）は、統一されたインターフェースでSpectra、Pendle、Morphoをクエリすることができます。以下のことが可能です。

• 発見：10のチェーン全体で同時に最適な固定レートの収益機会を見つけます。
• 分析：完全なデータ（APY、TVL、流動性、価格）を使用して、特定のPT/YTポジションを分析します。
• 計算：自動検出された借入レートを使用して、レバレッジルーピング戦略（Spectra PT + Morpho担保）を計算します。
• 比較：固定収益と変動収益を比較し、適切な判断を下します。
• 追跡：Merkl報酬を統合したすべてのSpectraポジション（PT、YT、LP）のウォレットポートフォリオを追跡し、完全な損益を把握します。
• 提示：SpectraとPendleの両方のプールと市場データとともに、外部のMerklキャンペーンのAPRを表示します。
• 監視：プールの取引ボリューム、個々のトランザクション活動、およびクロスプールのアドレススキャンを監視します。
• 見積もり：オンチェーンのCurve get_dy()を使用してPT取引を見積もり、正確な出力を得ます。数学的な推定にフォールバックすることもできます。
• シミュレーション：仮想的な取引後のポートフォリオの状態をシミュレートします（取引前/取引中/取引後の差分を表示）。
• スキャン：すべてのチェーンをスキャンし、価格インパクト、実効APY、およびMorphoルーピング分析を考慮した資本に配慮した機会を見つけます。
• 検出：IBT APRがYTの暗黙のレートから逸脱するYTアービトラージの機会を検出します。
• 計算：Baseからのライブオンチェーンデータを使用して、プールごとの実際のveSPECTRAブースト乗数を計算します。
• 発見：すべてのチェーンでライブのMetaVaultを見つけます。キュレーター情報、TVL、APY、ポジション、エポック履歴が表示されます。
• モデリング：キュレーター向けのMetaVaultの「ダブルループ」戦略をモデリングします。ライブAPIデータまたは手動パラメータから自動的にデータを取得します。
• 監視：MetaVaultの運用健全性を監視します。キュレーターダッシュボードには、ポジションごとのボート割り当て、預金者の流れ、手数料収入、ブリッジ活動、およびアクション可能なアラートが表示されます。
• クエリ：Morphoの貸出市場をクエリして、PT担保の機会を見つけ、貸出流動性の供給元を特定し、市場全体のボート割り当てを発見します。
• クエリ：プロトコルの統計、トークノミクス、およびガバナンスデータをクエリします。
• 比較：重複するチェーンでSpectraとPendleの収益機会を並べて比較し、満期を考慮したマッチングを行います。
• スキャン：SpectraとPendleの両方をスキャンして、資本に配慮したサイズ設定とクロスプロトコルのマッチタグ付けを行い、最適なキュレーターの機会を見つけます。
• 閲覧：Pendleがサポートするすべてのチェーン（Mantle、Berachain、HyperEVM、CornなどのPendle専用チェーンを含む）のPendle市場を閲覧します。
• 分析：Pendle市場を詳細に分析します。市場の詳細、ポートフォリオの追跡、取引見積もり、取引シミュレーション、ルーピング戦略、YTアービトラージ、満期監視、収益カーブ、容量分析、およびプロトコル全体の統計（Spectraツールと完全な同等機能）が含まれます。
• 評価：マルチサイズの容量カーブを使用してプールの深さを評価します。幾何学的な資本レベルでPT取引を見積もり、SpectraとPendleの両方で最適なポイントと枯渇ポイントを見つけます。
• 検証：デプロイ前にIBTの健全性を検証します。オンチェーンのERC - 4626変換レート、APRの持続可能性（有機的なものとインセンティブによるもの）、プールの残高、プロトコルの認識、流動性を確認します。
• 可視化：すべてのチェーンの任意の基準資産に対する収益カーブ（期間構造）を可視化します。すべての満期が時系列で並べられ、カーブの形状分析が行われます。
• 回復：APIデータが古くなった場合に、eth_getLogsを使用して過去のオンチェーンのプール活動を回復します。任意のチェーンに対する動的なRPC URLのサポートがあります。
• 監視：キュレーターのMorphoポジションの健全性を監視します。清算距離、借入レートのドリフト、すべてのチェーンの健全性因子を確認します。
• ストレステスト：MetaVaultの引き出しシナリオをストレステストします。流動性のウォーターフォール分析（アイドル → 満期 → LPの削除 → PTの売却）と市場ストレスのシミュレーションが含まれます。
• 計画：満期するMetaVaultポジションのロールオーバーを計画します。クロスプロトコルの候補をランキングし、エントリーインパクト、収益ギャップ、および重複ウィンドウを考慮します。
• 集約：マルチボートのキュレーターポートフォリオを集約します。総AUM、ブレンドAPY、手数料収入の予測、基準資産/チェーンごとの集中度分析が含まれます。
• 監視：すべてのチェーンのプールの満期を監視し、準備状況を評価します。後続プールの検出、ガバナンスAPIからのゲージステータス、およびオペレーターのチェックリスト（後続プールのデプロイ / ゲージの提案の提出 / 移行の準備完了）が含まれます。
• 学習：mv_get_protocol_contextを使用して、必要に応じてプロトコルの仕組みを学習します（PT/YTの識別、Routerのバッチ処理、預金パス、用語集、ワークフロールーティング）。

エージェントはPT/YTの仕組みを理解する必要はありません。資本サイズを指定してspectra_scan_opportunitiesまたはpendle_scan_opportunitiesを呼び出すだけで、ランク付けされた実行可能なデータを取得できます。クロスプロトコルの比較には、mv_scan_curator_opportunitiesが両方のプロトコルを一緒にランク付けします。何がそのように機能するのかを理解する必要がある場合は、mv_get_protocol_contextを呼び出します。

✨ 主な機能

オープンエマージェンスアーキテクチャ

サーバーは、AIエージェントが特定の戦略を教えられることなく、新しい戦略を発見できるように設計されています。戦略識別ロジックをハードコーディングする代わりに、システムは3つのレイヤーでプロトコルの仕組みを教え、エージェントがビルディングブロックを組み合わせて独自の分析を行えるようにします。

3つのレイヤー

レイヤー1: プロトコルコンテキスト (mv_get_protocol_contextツール + リソース)
  → プロトコルの「物理法則」を教えます: PT/YTの識別、Routerのバッチ処理、ミント
  → 呼び出し可能なツール（必要に応じて）およびMCPリソースとして利用可能
  → 静的な知識 — 何が起こりうるかを示し、何が起こっているかではない

レイヤー2: ツールの説明 (各ツールの説明文字列)
  → そのツールのデータに関連するドメイン固有の仕組みを教えます
  → 相互参照のヒント: "spectra_get_portfolioを使用して実際の保有量を確認してください"
  → "could be"（可能性がある）という表現を使用し、"is"（実際には）ではない — 存在する曖昧さを維持する
  → 誤解を招く可能性のある隠れた仕組みを指摘します (例: AMM_ADD_LIQUIDITYはYTをミントすることができる)

レイヤー3: 構造化された出力ヒント (ツールの出力で実行時に計算される)
  → ポートフォリオのポジション形状分析: 残高比率 (例: "YT/PT 4:1")
  → ポートフォリオのシグナル: 集中度、満期アラート、ポジション全体の戦略形状
  → ボリュームのシグナル: ボリューム/流動性比率、売買の偏り、トレンド検出
  → Morpho市場のヒント: 容量警告、利用率アラート、スプレッド分析、報酬インセンティブ
  → Morpho供給側分析: 供給者の識別 (ボート/EOA/ルーパー)、集中度メトリクス、
    供給ギャップ警告 — 貸出流動性の供給元とそれが十分かどうかを明らかにする
  → アドレスごとの活動分析における競合する解釈ブランチ (A/B/C):
    同じ観測パターンに対する複数の説明を、同等の重みで提示します。
    エージェントは外部の証拠を持ち込んでブランチを縮小する必要があります — 緊張感こそが情報です。
  → 統計的な信頼境界: 小さなサンプルサイズのサイクル繰り返し (≤5) は、外挿に不十分であるとフラグ付けされ、誤ったパターンマッチングを防ぎます
  → 競合する仮説によるフロー会計: YTのみ、PTのみ、完全に退出したポジション
    それぞれが異なる将来の挙動を予測する複数の説明を持ちます
  → アドレスの隔離モード: サイクル検出、フロー会計、コントラクト/EOA検出、
    プールの影響警告、ガス推定、プールのコンテキスト
  → 資本に配慮した警告: 短期満期、低流動性、負の実効APY
  → スキャン出力の収益次元: 固定、変動、LP、ルーピングを並べて表示
  → 戦略の緊張: 同じプールでの競合するPTルーピングとYT蓄積
  → オンチェーンの見積もりソースの指標: "(オンチェーンのCurve get_dy)" 対 "(推定値)"
  → 収益の構成: スキャンと見積もりにおけるIBT APRの内訳 (有機的なベースと外部のインセンティブ)
  → インセンティブの持続可能性: IBT APRまたはLP APYの50%以上がインセンティブに由来する場合にフラグ付けし、
    「有機的なみ」のAPYを表示して、エージェントがインセンティブの仮定なしで収益の持続性を評価できるようにする
  → プールの準備金: AMMの不均衡分析のためのIBT/PTの量と比率
  → MerklキャンペーンのAPR: 外部のインセンティブプログラム (例: KAT報酬) をプール/市場ごとに表示し、
    重複カウントを回避します (報酬トークンがすでに表示されているキャンペーンをスキップする)
  → ポイント乗数: 外部のプログラム (Drops、InfiniFi、Firelight) とその量
  → "could be" / "現行レートで" という表現: ランク付けされた出力の曖昧さを維持する
  → 重要なシグナルを目立たせるが、解釈を規定しない

レイヤー4: 観測カバレッジ (ツールの出力における死角を定量化する)
  → 値のカバレッジ: アドレスのポジションのどの割合が観測可能な活動で説明されるか。
    低いカバレッジは、ほとんどの行動が見えないことを意味します (直接のミント、転送、クロスチェーン)。
  → 時間的なカバレッジ: 観測可能なイベントがない暗黙の期間とアクティブな日数。
    最長のギャップ期間を明らかにして、エージェントが見えない活動について推論できるようにする。
  → データソースのカバレッジ: 利用可能な5つのソースのうち、どれが参照されたか、参照されなかったか。
    現在の分析で見えないものを明示的にリストする。
  → 活動の多様性: 単一タイプの活動は、最も曖昧なパターンとしてフラグ付けされる。
  → 境界マーカー: "ポジションのサイズ設定は、この分析が不完全であり、包括的ではないことを前提とする必要があります。" — 有効性のドメインの限界を構造的に認める。
  → カバレッジメトリクスは、それらより上のすべての解釈を制限します。高い信頼度の戦略評価 + 低い観測カバレッジ = 誤った信頼。カバレッジセクションは、エージェントが実際に観測したことに応じて確信度を調整するように強制します。

設計原則

• 仕組みを教える、結論を教えない。サーバーは、AMM_ADD_LIQUIDITYがミント+LPバッチ操作である可能性があることを説明しますが、「このユーザーはYTを蓄積している」という結論を下しません。
• 競合する解釈を提示する、単一の物語を提示しない。活動分析の出力は、異なる将来の挙動を予測する複数の解釈ブランチ（A/B/C）を含みます。エージェントは外部の証拠を持ち込んでそれらを縮小する必要があります。この摩擦面は、早期のパターンマッチングを防ぎます — ウォレット戦略分析で最も一般的な失敗モードです。
• 統計的な不十分さをフラグ付けする。小さな繰り返しカウント（≤5サイクル検出）は、外挿に不十分であると明示的にフラグ付けされます。エージェントはN = 3を確認されたパターンとして扱うことはできません。
• すべてのツールは少なくとも1つの他のツールを相互参照する。これにより、分析ワークフローが作成されますが、それを規定することはありません。エージェントは、活動パターンを見た後にspectra_get_portfolioをチェックするように学習しますが、それが指示されたからではありません。
• 誤解を招く可能性のある隠れた仕組みを指摘する。Spectra Routerは複数の操作をアトミックにバッチ処理します。SELL_PTイベントは、実際にはフラッシュミントを介したYTの取得である可能性があります。ツールの説明はこれを教えるので、エージェントがプールデータだけから誤った結論を引き出すことがないようにします。
• 出力には完全なアドレスを表示する、切り捨てない。アドレスが活動データに表示される場合、それらは完全に表示されるので、エージェントはブロックエクスプローラーを使用することなく、それらを直接spectra_get_portfolioに渡すことができます。
• 発見ツールは資本配慮のギャップについて警告する。spectra_get_best_fixed_yieldsは、「これは生のAPYでランク付けされています — 資本配慮のサイズ設定にはspectra_scan_opportunitiesを使用してください」と明示的に述べています。
• 死角を定量化する、解釈だけでなく。ツールは現在、観測カバレッジメトリクスを出力します。どの割合の行動が可視化されているか、参照されたデータソースと利用可能なデータソースは何か、および暗黙の期間はどれくらい続いたか。これらは解釈ではなく、分析自体の不完全性の構造的な測定値です。35％の値のカバレッジを見るエージェントは、最も適合する解釈がどれほど首尾一貫して見えようとも、その確信度を適切に調整する必要があります。

これが重要な理由

プロトコルに関する事前知識がゼロのコールドスタートエージェントは、以下のことができます。

1. mv_scan_curator_opportunitiesを呼び出す — 資本配慮のメトリクスを含むクロスプロトコル（Spectra + Pendle）の収益ランキングを表示する
2. spectra_get_pool_activityを呼び出す — 曖昧なイベントに関する⚠ヒント付きの取引パターンを表示する
3. フラグ付けされたアドレスでspectra_get_portfolioとpendle_get_portfolioを呼び出す — 両方のプロトコルのポジション形状を表示する
4. 相互参照のヒントを読む — すべての3つのプロトコルにまたがる独自の分析ワークフローを構築する
5. サーバーに明示的にプログラムされていない新しい戦略を識別する

これは検証されています。事前学習がゼロのサブエージェントが、3つのツール呼び出しで、説明で教えられた仕組みと出力の構造化されたヒントのみを使用して、ミントしてPTを売却するループ戦略（PT割引を介したYT蓄積）を正しく識別しました。

競合するブランチの設計は、実際の失敗によって動機付けられました。マルチチェーンウォレットを分析するエージェントが、異なるプールが異なるパターン（スプレッドキャプチャ、マーケットメイキング、LPサイクリング）を示しているにもかかわらず、すべての活動を「YTアキュムレーター」にまとめました。単一の物語の失敗モード — エージェントが1つの解釈を選択してそれを擁護するモード — は、内部からは良い分析のように見えるため、最も危険です。

観測カバレッジレイヤーは、より深い問題に対処します。観測データの完全な解釈でさえ、データが行動の少数をカバーしている場合には誤解を招きます。競合するブランチは「物語」の問題（どの物語が適合するか）を解決します。カバレッジメトリクスは「露出」の問題（私が全体のどれくらいを見ているか）を解決します。最適な解釈ブランチを選択するが、65％の見えない活動を無視するエージェントは、一貫性に基づいて確信度を調整していますが、証拠に基づいていません。

ツール

サポートされるチェーン

Spectra：Ethereum (メインネット)、Base、Arbitrum、Optimism、Avalanche、Katana、Sonic、Flare、BSC、Monad

Pendle：Ethereum、Optimism、BSC、Sonic、Base、Arbitrum、Mantle、Berachain、HyperEVM、Corn

veSPECTRAブースト

サーバーは、生のeth_callを介してBaseチェーンから直接ライブのveSPECTRA総供給量を読み取り（ethers/viemの依存関係なし）、実際のSpectraの式を使用してプールごとのブースト乗数を計算します。

B = min(2.5, 1.5 * (v/V) * (D/d) + 1)

v = あなたのveSPECTRA残高
V = 総veSPECTRA供給量 (Baseからライブで読み取られる)
D = プールのTVL
d = あなたの預金サイズ

あなたの総veSPECTRAのシェア >= プールのTVLのシェアの場合、最大2.5倍のブーストが適用されます。

ve_spectra_balanceを受け入れるツール（spectra_scan_opportunities、spectra_scan_yt_arbitrage、spectra_compare_yield、spectra_get_ve_info）は、自動的にプールごとのブーストを計算します。veSPECTRAコントラクトは、Base上のNFTベースの投票エスクロー（veNFT）であり、アドレスは0x6a89228055c7c28430692e342f149f37462b478bで、[spectra - core](https://github.com/perspectivefi/spectra - core)から取得されます。

MetaVaultの発見と戦略モデリング

MetaVaultは、ERC - 7540で管理されるボートで、LPのロールオーバーを自動化し、YT収益をLPポジションに再投資します。2つのツールが連携して機能します。

spectra_list_metavaults — 発見ツールです。API (/v1/{network}/metavaults) からライブのMetaVaultデータを取得し、単一のチェーンまたはすべてのチェーンを並列にスキャンします。キュレーター情報、TVL、ライブのAPY、シェア価格、PT/プールの詳細を含むアクティブなポジション、およびエポックレートの履歴を返します。

spectra_model_metavault — 2つのモードを持つ戦略モデラーです。

• ライブモード：chain + metavault_addressを指定すると、ボートのライブのAPYがbase_apyとして自動的に取得されます。他のすべてのパラメータ（借入レート、LTV、キュレーター手数料）は依然として上書きできます。
• 手動モード：base_apyを直接指定して、仮想的なまたは事前のモデリングを行います。

「ダブルループ」の経済学：

レイヤー1 (ボート内):  預金 → PT/LP割り当て → YT収益 → より多くのLP (複利)
レイヤー2 (上位):        MVシェア → Morpho担保 → 借入 → 再預金 (レバレッジ)

重要な洞察：YTの複利はボートの基本APYを上げ、レバレッジはその高い基本APYを乗数します。これにより、生のPTルーピングに比べて「ダブルループプレミアム」が生まれ、レバレッジに応じて拡大します。

キュレーターの経済学が組み込まれています。このツールは、外部預金に対する手数料収入、ルーピングによって作成される追加のTVL、およびキュレーター自身の資本に対する実効ROIをモデリングします。

📦 インストール

npmからのインストール (推奨)

npm install -g metavault-mcp

または、インストールせずに直接実行することもできます。

npx metavault-mcp

ソースからのインストール

git clone https://github.com/Finanzgoblin/metavault-mcp.git
cd metavault-mcp
npm install
npm run build

Claude Desktopへの接続

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "metavault-mcp": {
      "command": "npx",
      "args": ["metavault-mcp"]
    }
  }
}

Claude Desktopを再起動します。すべての50のツール（Spectra、Pendle、Morpho、クロスプロトコル）が利用可能になります。

Claude Codeへの接続

claude mcp add metavault-mcp -- npx metavault-mcp

💻 使用例

深い分析のプロンプト

最初に与えるコンテキストが多いほど、エージェントはより深い分析を行うことができます。各入力は異なるツールチェーンを開きます。

理想的なプロンプトは、これらすべてを組み合わせたものです。 以下は、8 - 10のツールチェーンをトリガーする例です。

• 収益ハンター: "私は$50KのUSDCと10,000のveSPECTRAを持っています。60 - 180日間の最適なリスク調整済み固定収益を見つけてください。IBTの健全性をチェックし、正確なエントリーを見積もり、プールにいる他の人を表示してください。"
• キュレーター: "私はBase上で$500Kの自己資本でUSDCのMetaVaultを構築しており、$2Mの外部資金を期待しています。ダブルループの経済学をモデリングし、SpectraとPendleのLP割り当てを比較してください。"
• 調査官: "ウォレット0xABC...はSpectraメインネットでアクティブです。すべてを表示してください — ポートフォリオ、すべてのプールの活動、シーケンス分析、および彼らが実行している戦略。"
• 期間構造: "すべてのチェーンのETH収益カーブを表示してください。期間プレミアムの異常はどこにありますか？上位3つの誤った価格設定に対して$200Kでのプール容量を見積もってください。"

ツー