Chainlist MCP Server

Chainlist MCP Server

Chainlist.org を情報源とし、RPC URL、チェーン ID、エクスプローラー、ネイティブトークンなど、検証済みの EVM チェーン情報に AI エージェントがすばやくアクセスできる MCP サーバーです。

特長

• 効率的なデータ取得：Chainlist API のデータをキャッシュして、リクエストを最小限に抑えます。
• 柔軟な検索：getChainsByKeyword では、大文字と小文字を区別しないキーワードマッチングに正規表現を使用します。
• 構造化された出力：読みやすいように、rpc と explorers を表形式で含む Markdown レスポンスを返します。

インストール

前提条件

• Python：バージョン 3.10 以降。
• uv：Python プロジェクトと依存関係の管理に推奨されます（pip install uv でインストールするか、uv のドキュメントを参照してください）。

手順

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

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

2. 依存関係をインストールする：

   uv sync
   

3. Claude Desktop にインストールする：

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

   uv run mcp install cli.py --name "Chainlist MCP"
   

   参考用の設定ファイル：

   {
      "mcpServers": {
          "Chainlist MCP": {
              "command": "uv",
              "args": [ "--directory", "/path/to/chainlist-mcp", "run", "main.py" ] 
          }
      }
   }
   

   /path/to/chainlist-mcp を実際のインストール先のパスに置き換えてください。

使い方

このサーバーは、MCP プロトコルを介して 2 つのツールを公開します。MCP 対応クライアントまたは MCP Inspector から利用できます。

ツール

getChainById

• 説明：チェーン ID を指定して、ブロックチェーンの詳細を取得します。
• パラメーター：
  • chain_id（整数）：ブロックチェーンの一意な識別子（例：Ethereum Mainnet の場合は 1）。
• 戻り値：チェーンの詳細またはエラーメッセージを含む Markdown 文字列。

プロンプトの例（MCP クライアント内）：

Get the details for the blockchain with chain ID 1.

レスポンスの例：

**Chain Details**
- **Name**: Ethereum Mainnet
- **Chain ID**: 1
- **Native Currency**: Ether (ETH, 18 decimals)
- **TVL**: 134376951329.85631
**RPC Endpoints**:
| URL                                          | Tracking |
|----------------------------------------------|----------|
| https://eth.llamarpc.com                     | none     |
| https://go.getblock.io/...                   | none     |
...
**Explorers**:
| Name       | URL                        | Standard |
|------------|----------------------------|----------|
| etherscan  | https://etherscan.io       | EIP3091  |
...

getChainsByKeyword

• 説明：キーワードを指定してブロックチェーンを検索します（大文字と小文字を区別しない部分一致）。
• パラメーター：
  • keyword（文字列）：検索するキーワードまたは名前の一部（例：'eth'）。
  • limit（整数、任意）：結果の最大件数（デフォルト：5）。
• 戻り値：limit 件までの一致したチェーンの一覧、またはエラーメッセージを含む Markdown 文字列。

プロンプトの例（MCP クライアント内）：

Find blockchains with 'eth' in their name, limit to 2 results.

レスポンスの例：

**Matching Chains**

### Chain 1
**Chain Details**
- **Name**: Ethereum Mainnet
- **Chain ID**: 1
- **Native Currency**: Ether (ETH, 18 decimals)
- **TVL**: 134376951329.85631
**RPC Endpoints**:
| URL                                          | Tracking |
|----------------------------------------------|----------|
| https://eth.llamarpc.com                     | none     |
...
**Explorers**:
| Name       | URL                        | Standard |
|------------|----------------------------|----------|
| etherscan  | https://etherscan.io       | EIP3091  |
...

### Chain 2
**Chain Details**
- **Name**: Ethereum Goerli
- **Chain ID**: 5
- **Native Currency**: Ether (ETH, 18 decimals)
- **TVL**: N/A
**RPC Endpoints**:
| URL                                          | Tracking |
|----------------------------------------------|----------|
| https://goerli.infura.io/...                 | yes      |
...
**Explorers**:
| Name       | URL                        | Standard |
|------------|----------------------------|----------|
| etherscan  | https://goerli.etherscan.io | EIP3091  |
...

ライセンス

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