Ens MCP

🚀 ENS MCP Server

ENSドメインのアクティビティを解決、分析、コンテキスト化するMCPサーバーです。Web3エージェントに人間が読めるアイデンティティの洞察を提供します。

✨ 主な機能

• ENS名の解決：ENSドメイン（例：vitalik.eth）をイーサリアムアドレスにマッピングします。
• 詳細なドメイン情報：アドレス、所有者、登録者、有効期限、登録日、ラップドドメイン、リゾルバーの詳細など、包括的なドメインデータを取得します。
• ドメインイベント履歴：転送、リゾルバーの変更、名前のラッピングなどのイベントを、関連するアドレスとタイムスタンプとともに取得します。

📦 インストール

必要条件

• Python 3.10以上
• uv（依存関係管理に推奨）
• The Graphの有効なAPIキー

インストール手順

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

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

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

   uv sync
   

3. Claude Desktopへのインストール： サーバーをClaude Desktopアプリケーションとしてインストールします。

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

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

   {
       "mcpServers": {
           "ens-mcp": {
               "command": "uv",
               "args": [ "--directory", "/path/to/ens-mcp", "run", "main.py" ],
               "env": { "THEGRAPH_API_KEY": "the_graph_api_key"}               
           }
       }
   }
   

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

💻 使用例

ツール

サーバーは3つのMCPツールを提供します。

基本的な使用法

1. resolve_ens_name(domain: str) -> str ENSドメインをそのイーサリアムアドレスに解決します。
   • 入力：ENSドメイン（例：vitalik.eth）
   • 出力：イーサリアムアドレス（例：0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045）または "None" 例:

   resolve_ens_name("vitalik.eth") -> "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
   

2. get_domain_details(domain: str) -> str ENSドメインに関する詳細情報を取得します。
   • 入力：ENSドメイン
   • 出力：ドメインの詳細（アドレス、所有者、登録者、有効期限など）が書式設定された文字列 出力例:

   ENS Domain: vitalik.eth
   Address: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
   Label Name: vitalik
   Label Hash: 0x...
   Subdomain Count: 5
   Owner: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
   Registrant: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
   Wrapped Owner: None
   Expiry Date: 2025-10-31 00:00:00
   TTL: 0 seconds
   Is Migrated: true
   Created At: 2017-05-04 12:00:00
   Registration: Registration Date: 2017-05-04 12:00:00
   Registration Expiry: 2025-10-31 00:00:00
   Registration Cost: 1000000000000000 Wei
   Registrant: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
   Wrapped Domain: Not Wrapped
   Resolver: Resolver Address: 0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41
   Content Hash: None
   Text Records: email, url
   

3. get_domain_events(domain: str) -> str ENSドメインに関連するイベントを取得します。
   • 入力：ENSドメイン
   • 出力：イベント（例：転送、リゾルバーの変更）をリストした書式設定された文字列 出力例:

   Event: Transfer
   Block Number: 1234567
   Transaction ID: 0x...
   New Owner: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
   
   Event: NewResolver
   Block Number: 1234568
   Transaction ID: 0x...
   Resolver Address: 0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41
   Resolver Addr: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
   

📄 ライセンス

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