Uniswap Pools MCP

🚀 Uniswap Pools MCP

Uniswap Pools MCPは、トークンアドレスでUniswapのプールやペアをクエリするためのMCPサーバーです。クリーンで構造化された結果を提供し、簡単に統合し分析することができます。

🚀 クイックスタート

Uniswap Pools MCPを使用することで、トークンアドレスに基づいてUniswapのプールやペアに関する情報を簡単に取得できます。以下のセクションでは、このサーバーの主な機能、インストール方法、使用例について説明します。

✨ 主な機能

• Uniswapのプール/ペアのクエリ:
  • 指定されたトークンアドレスに対するV2、V3、V4のプール/ペアを取得します。
  • バージョン (v2, v3, v4) とIDによって特定のプール/ペアの詳細を取得します。
• 整形された出力:
  • 複数のプールクエリに対しては、データをMarkdownテーブルで返します。
  • 特定のプール/ペアクエリに対しては、トークンアドレスを含むMarkdownテキストの要約を提供します。

📦 インストール

前提条件

• Python: バージョン3.10以上。
• uv: Pythonパッケージマネージャー（依存関係の管理に推奨）。
• The Graph API Key: サブグラフをクエリするために必要です。The Graph から取得してください。

セットアップ

1. リポジトリのクローン:

   git clone https://github.com/kukapay/uniswap-pools-mcp.git
   cd uniswap-pools-mcp
   

2. 依存関係のインストール:

   uv sync
   

3. Claude Desktopへのインストール:

   サーバーをClaude Desktopアプリケーションとしてインストールします:

   uv run mcp install main.py --name "Uniswap Pools"
   

   参考としての設定ファイル:

   {
      "mcpServers": {
          "Uniswap Pools": {
              "command": "uv",
              "args": [ "--directory", "/path/to/uniswap-pools-mcp", "run", "main.py" ],
              "env": { "THEGRAPH_API_KEY": "thegraph-api-key"}               
          }
      }
   }
   

   /path/to/uniswap-pools-mcp を実際のインストールパスに置き換え、thegraph-api-key をThe Graphから取得したAPIキーに置き換えてください。

💻 使用例

基本的な使用法

サーバーは、Uniswapのプール/ペアデータをクエリするためのいくつかのツールを提供しています。

ツール

1. トークンのすべてのプール/ペアの取得:

   def get_token_pools(token_address: str) -> str:
   

   • 説明: 指定されたトークンアドレスに対するすべてのUniswap V2、V3、V4のプール/ペアをクエリします。

   • パラメーター:

     • token_address (str): トークンのEthereumアドレス（例: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 はUSDC）。

   • 出力: バージョン、ID、ペア、手数料レベル、USD取引量、流動性/USD準備金、USD手数料の列を持つMarkdownテーブル。

   • 例:

     プロンプト:

     Get Uniswap pools for token at address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
     

     出力:

     | Version | ID                                         | Pair      | Fee Tier | Volume USD | Liquidity/ReserveUSD | Fees USD |
     |---------|--------------------------------------------|-----------|----------|------------|---------------------|----------|
     | v2      | 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc | USDC/WETH | 3000     | 2000000.0  | 500000.0            | N/A      |
     | v3      | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 | USDC/WETH | 500      | 1000000.0  | 123456789           | 5000.0   |
     | v4      | 0x1234567890abcdef1234567890abcdef12345678 | USDC/WETH | 1000     | 500000.0   | 987654321           | 2500.0   |
     

2. バージョンとIDによる特定のプール/ペアの取得:

   def get_pool_data(version: str, pool_id: str) -> str:
   

   • 説明: バージョン (v2, v3, または v4) とIDによって特定のUniswapプール/ペアをクエリします。

   • パラメーター:

     • version (str): Uniswapのバージョン (v2, v3, または v4)。
     • pool_id (str): プールまたはペアのEthereumアドレス（例: 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc）。

   • 出力: バージョン、ID、ペア、トークン0アドレス、トークン1アドレス、手数料レベル、USD取引量、流動性/USD準備金、USD手数料の詳細を持つMarkdownテキスト。

   • 例:

     プロンプト:

     Get Uniswap V2 pool data by ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
     

     出力:

     **Uniswap V2 Pair Details**
     - **Version**: v2
     - **ID**: 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
     - **Pair**: USDC/WETH
     - **Token0 Address**: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
     - **Token1 Address**: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
     - **Fee Tier**: 3000 (0.3%)
     - **Volume USD**: 2000000.0
     - **Liquidity/ReserveUSD**: 500000.0
     - **Fees USD**: N/A
     

📄 ライセンス

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