DeFiMind

⚠ 廃止（2026-10-23）。 この MCP サーバーはホストされなくなりました。公開 エンドポイント mcp.echoledger.ai はオフラインになり、掲載も削除されました。参考用に 残されています。メンテナンスされておらず、デプロイもされていません。

echoledger-mcp

EchoLedger の MCP サーバーです。MCP 対応 AI クライアントから、Uniswap V2/V3、Balancer、Curve の ライブプールを分析できます。対象はポジション、価格変動、プールの健全性、ラグの 兆候、スリッページ、デペッグリスクです。また、MCP 外で分析するためのポータブルな State Twin を構築できます。呼び出し元が指定する RPC を使って実際のチェーン 状態を読み取ります。エンドポイント自体は認証不要です。

エンドポイント：https://mcp.echoledger.ai/mcp（streamable-HTTP、認証不要）。

インストール

Claude Desktop

Settings → Integrations → Add server を選択します。 URL：https://mcp.echoledger.ai/mcp

Claude Code

claude mcp add --transport http echoledger https://mcp.echoledger.ai/mcp

Cursor

Settings → MCP → Add new MCP server を選択します。 Name：echoledger · Type：http · URL：https://mcp.echoledger.ai/mcp

Smithery

smithery.ai/servers/ic3moore/echoledger に掲載されています。対応クライアントから Smithery ゲートウェイ経由で接続できます。

ツール

このエンドポイントは、Uniswap V2/V3、Balancer の ウェイト付きプール（2資産）、Curve のステーブルスワップ（2資産）を対象とする11個のツールを提供します。2つの用途があります。

• 10個のリアクティブなプリミティブ — 1つの質問に対し、1つの回答を返し、チェーンを1回読み取ります。 そのうち4つはベクトル入力（例：price_change_pcts[]、 amounts_in[]）にも対応し、1回の呼び出しでグリッドや曲線全体を走査できます。
• BuildStateTwin — ポータブルな State Twin（プールの状態を JSON で表したもの）を返します。クライアント側で再構成すれば、追加の RPC を一切使わずに、 MCP 外で無制限の反実仮想を実行できます。

各呼び出しでは、pool_address、rpc_url、pool_type に加え、 任意の chain_id ガードと block_number 固定値を指定します。データは保存されません。 各リアクティブツールはプロトコル固有であり、受け付ける pool_type の値のみを 明示します。未対応の種類を指定すると、チェーンを読み取る前に明確なエラーを返します。

完全なリファレンス — パラメーター、戻り値、各ツールの検証済みの使用例： docs/TOOLS.md。

対象範囲： Balancer ツールは2資産のウェイト付きプールに対応し、 ステーブルスワップツールは2資産の通常の Curveプールに対応します（メタプールや LSD など、レートを持つプールは後のリリースで対応予定です）。3コインまたはレートを持つプールに stableswap ツールを指定すると、明確なエラーが返されます。

Uniswap V2/V3

AnalyzePosition

LP ポジションの損益を、インパーマネントロス、手数料、純損益に分解します。

「V3 USDC/ETH プールでの自分のポジションを分析してください。」

SimulatePriceMove

「価格が X% 動いたらどうなるか？」— 推定準備金、ポジション価値、IL を返します。

「ETH が 20% 下落したら、V3 ETH/DAI ポジションはどうなりますか？」

CheckPoolHealth

プールの TVL、準備金、LP の集中度、最近のアクティビティを確認します。

「この V3 プールは健全ですか？」

DetectRugSignals

プールのオンチェーン状態に基づき、しきい値を用いてラグの兆候を検出します。

「この V2 ペアにラグの兆候はありますか？」

CalculateSlippage

指定した取引のスリッページ、価格インパクト、最大取引サイズを計算します。

「この V3 プールで 50 ETH を購入すると、スリッページはどのくらいですか？」

Balancer（2資産のウェイト付き）

AnalyzeBalancerLP

2資産の Balancer ウェイト付きプールにおけるポジションの損益を分解します。 トークンのウェイトが IL の大きさに影響するウェイト付きプール用の IL 公式を使用します。

「80/20 BAL/WETH の Balancer ポジションの状況を教えてください。」

SimulateBalancerMove

「基準トークンが X% 動いたらどうなるか？」— 2資産のウェイト付きプールで、 ウェイトを考慮した推定価値と IL を返します。

「BAL が 30% 下落したら、BAL/WETH の Balancer LP はどうなりますか？」

Curve ステーブルスワップ（2 アセット、プレーン）

AnalyzeStableswapLP

増幅不変量の IL 公式を用いて、2 アセットの Curve ステーブルスワップポジションの損益を分解します。A が大きい場合、小さなデペッグでも大きな IL が発生する可能性があります。

「crvUSD/USDC プールでのポジションを分析してください。」

SimulateStableswapMove

「ペッグが X% 変動したらどうなりますか？」— 2 アセットのステーブルスワッププールの予測価値と IL を算出します。A が大きい場合、大きなショックは物理的に到達できないことがあり、その場合は null が返されます。

「USDC が 2% デペッグしたら、USDC/DAI の Curve LP はどうなりますか？」

AssessDepegRisk

2 アセットのステーブルスワップポジションについて、デペッグ幅を段階的に変えた場合（デフォルトは 2%、5%、10%、20%、50%）の IL を算出します。オプションでコンスタントプロダクトをベンチマークにできます。

「crvUSD/USDC ポジションはデペッグにどの程度さらされていますか？」

ステートツインビルダー（4 種類すべてのプールタイプ）

BuildStateTwin

プールを 1 回読み取り、ポータブルなステートツイン（プールの状態を JSON 形式（__type__ とフィールド、content_hash を含む）で表したもの）を返します。クライアント側で再構築すれば、MCP の外部で、追加の RPC を一切使わずに、価格変動、IL、スリッページなどの反実仮想分析を何度でも実行できます。1 回構築すれば、N 回実行できます。4 種類すべてのプールタイプに対応しています。docs/TOOLS.md のツインの往復処理と、echoledger パッケージを参照してください。

「USDC/ETH 0.05% プールの再利用可能なツインを構築してください。」

(正直な制約：これは単一ブロックの STATE ツインです。履歴に基づく健全性指標は、CheckPoolHealth／DetectRugSignals 内で引き続きサーバー側から読み取ります。)

仕組み

echoledger-mcp は、呼び出し元から渡された RPC エンドポイント（BYO-RPC、各ツール呼び出し時に指定）を通じて、Uniswap V2/V3、Balancer、Curve ステーブルスワップのライブプール状態を読み取ります。エンドポイントに認証は不要です（API キーもアカウントも不要です）。ログ記録や保存は行いません。呼び出しごとに状態を取得して分析を実行し、型付きの結果を返します。

分析機能には、オープンソースの DeFiPy を採用しています。合成レシピで実行されるものと同じプリミティブ、ツイン、ツールを、実際のプールに適用しています。数式はオープン、レポートは有料です。

ロードマップ

• v0.2 — Balancer と Stableswap のライブ読み取り ✓ リリース済み。5 つの Balancer／Stableswap ツールが DeFiPy 2.2 の LiveProviders で利用可能になりました（2 アセットの加重プールと、2 アセットのプレーンな Curve）。
• v0.2.2 — 正確なスキーマ、ベクトル、ツインビルダー ✓ リリース済み。ツールごとの pool_type 列挙型、4 つのシナリオツールでのベクトル化されたシナリオ入力、および 11 番目のツールとして BuildStateTwin（ポータブルな、MCP 外部でのツイン分析用）を追加しました。
• N アセットおよび金利連動型プール — 上流の DeFiPy プリミティブが 2 アセットを超えて対応した後に、3 アセットの Balancer、N コインおよび金利連動型（メタプール／LSD）の Curve に対応します。
• 配布の仕上げ — OCI パッケージの掲載、DNS 検証済みの名前空間、OIDC による自動公開。

開発

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

ストリーミング可能な HTTP でサーバーを実行します（$PORT にバインドします。デフォルトは 8080）：

PORT=8080 python -m echoledger_mcp.server      # endpoint at http://localhost:8080/mcp

または、ローカルの MCP Inspector でスモークテストを行う場合は stdio で実行します：

python -m echoledger_mcp.server --stdio
npx @modelcontextprotocol/inspector python -m echoledger_mcp.server --stdio

テスト（オフライン — フェイクプロバイダーと実際のツイン／プリミティブを使用）：

pytest tests/

ライブ RPC のゲート（実際のメインネット Uniswap V2/V3、Balancer、Curve プールを使用。独自の RPC が必要です）：

ECHOLEDGER_TEST_RPC_URL="https://eth-mainnet.example/v2/<key>" pytest tests/test_live.py -v

ライセンス

Apache-2.0。LICENSE および NOTICE を参照してください。

このプロジェクトは DeFiPy（Apache-2.0）のコードを応用しています。

関連項目

• DeFiPy（オープンソースの基盤）：https://defipy.org
• EchoLedger：https://echoledger.ai
• ステートツイン論文：https://arxiv.org/abs/2605.11522