Uniswap PoolSpy MCP Server

Uniswap PoolSpy MCP Server

9 つのブロックチェーンネットワーク（Ethereum、Base、Optimism、Arbitrum、Polygon、BNB Smart Chain（BSC）、Avalanche、Celo、Blast）において、新たに作成された Uniswap の流動性プールを追跡する MCP サーバーです。DeFi アナリスト、トレーダー、開発者にリアルタイムのデータを提供します。

特長

• 9 つのブロックチェーンネットワークにおける Uniswap V3 のプール作成を監視します。
• 新しいプールを検索する際の期間と結果数をカスタマイズできます。
• タイムスタンプ、トランザクション数、取引量、TVL による並べ替えに対応しています。

前提条件

• Python 3.10 以降
• パッケージ管理用の uv
• 有効な The Graph API キー
• 完全な機能を利用するには、MCP 対応環境（例：Claude Desktop）

インストール

1. リポジトリをクローンする：

   git clone https://github.com/yourusername/uniswap-poolspy-mcp.git
   cd uniswap-poolspy-mcp
   

2. 環境をセットアップする： まだインストールしていない場合は、uv をインストールします：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. 依存関係をインストールする： uv を使用して、pyproject.toml から依存関係を同期します：

   uv sync
   

4. API キーを設定する： プロジェクトのルートに .env ファイルを作成します：

   echo "THEGRAPH_API_KEY=your-api-key-here" > .env
   

   your-api-key-here を実際の The Graph API キーに置き換えます。

使用方法

サーバーの実行

MCP サーバーを起動します：

uv run main.py

MCP Inspector を使用した開発の場合：

uv run mcp dev main.py

Claude Desktop との統合

サーバーを MCP プラグインとしてインストールします：

uv run mcp install main.py --name "UniswapPoolSpy"

設定

MCP クライアント（例：Claude Desktop）がサーバーを検出できるようにするには、mcpServers ファイルで設定します：

{
  "mcpServers": {
    "Uniswap-PoolSpy": {
      "command": "uv",
      "args": ["--directory", "path/to/uniswap-poolspy-mcp", "run", "main.py"],
      "env": {
        "THEGRAPH_API_KEY": "your api key from The Graph"
      }
    }
  }
}

新しいプールの検索

Claude Desktop で get_new_pools ツールを使用し、次のような自然言語で検索します：

• 「過去 10 分間に Ethereum で作成された新しいプールを表示して」
• 「Base のプールを取引量順に並べて、50 件まで表示して」
• 「過去 1 時間に Polygon で作成されたプールを、TVL 順に表示して」

このツールでは、次のパラメーターを指定できます：

• chain：ブロックチェーンネットワーク（例：「ethereum」、「base」、「optimism」）
• order_by：並べ替えフィールド（「timestamp」、「txcount」、「volume」、「tvl」）
• time_range_seconds：遡る期間（秒単位、デフォルト：300）
• limit：返すプールの最大数（デフォルト：100）

出力例

Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
Pool Address: 0x1234...abcd
Tokens: WETH/USDC
Created At: 2025-03-18 12:34:56
Block Number: 12345678
Transaction Count: 5
Volume (USD): 15000.25
Total Value Locked (USD): 50000.75

Pool Address: 0x5678...efgh
Tokens: DAI/USDT
Created At: 2025-03-18 12:33:45
Block Number: 12345670
Transaction Count: 3
Volume (USD): 8000.50
Total Value Locked (USD): 25000.00

対応チェーン

• Ethereum
• Base
• Optimism
• Arbitrum
• Polygon
• BNB Smart Chain（BSC）
• Avalanche
• Celo
• Blast

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。