返回市场
链表-mcp

链表-mcp

作者:kukapay2 星标更新:2025-06-01

项目介绍

Chainlist MCP 服务器

一个提供给AI代理快速访问验证过的EVM链信息的MCP服务器,包括RPC URL、链ID、区块浏览器和原生代币——这些数据来源于Chainlist.org。

GitHub License Python Version Status

特性

  • 高效数据获取:缓存Chainlist API数据以减少请求次数。
  • 灵活搜索:使用正则表达式进行大小写不敏感的关键字匹配,用于getChainsByKeyword
  • 结构化输出:以Markdown格式返回结果,带有表格化的rpcexplorers内容,便于阅读。

安装

预备条件

  • 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桌面

    将服务器作为Claude桌面应用程序安装:

    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协议暴露两个工具,可以通过兼容MCP的客户端或MCP Inspector访问。

工具

getChainById

  • 描述:根据区块链的链ID检索其详情。
  • 参数
    • chain_id(整数):区块链的唯一标识符(例如,1代表以太坊主网)。
  • 返回值:包含链详情的Markdown字符串或错误消息。

示例提示(在MCP客户端中):

获取链ID为1的区块链详情。

示例响应

**链详情**
- **名称**:以太坊主网
- **链ID**:1
- **原生货币**:以太币(ETH,18位小数)
- **TVL**:134376951329.85631
**RPC端点**:
| URL                                          | 跟踪 |
|----------------------------------------------|------|
| https://eth.llamarpc.com                     | 无   |
| https://go.getblock.io/...                   | 无   |
...
**区块浏览器**:
| 名称       | URL                        | 标准   |
|------------|----------------------------|--------|
| etherscan  | https://etherscan.io       | EIP3091 |
...

getChainsByKeyword

  • 描述:通过关键字搜索区块链(大小写不敏感的部分匹配)。
  • 参数
    • keyword(字符串):要搜索的关键字或部分名称(例如,'eth')。
    • limit(整数,可选):结果的最大数量(默认值:5)。
  • 返回值:列出最多limit个匹配链的Markdown字符串或错误消息。

示例提示(在MCP客户端中):

查找名称中含有'eth'的区块链,限制结果为2条。

示例响应

**匹配的链**

### 链1
**链详情**
- **名称**:以太坊主网
- **链ID**:1
- **原生货币**:以太币(ETH,18位小数)
- **TVL**:134376951329.85631
**RPC端点**:
| URL                                          | 跟踪 |
|----------------------------------------------|------|
| https://eth.llamarpc.com                     | 无   |
...
**区块浏览器**:
| 名称       | URL                        | 标准   |
|------------|----------------------------|--------|
| etherscan  | https://etherscan.io       | EIP3091 |
...

### 链2
**链详情**
- **名称**:以太坊Goerli测试网
- **链ID**:5
- **原生货币**:以太币(ETH,18位小数)
- **TVL**:N/A
**RPC端点**:
| URL                                          | 跟踪 |
|----------------------------------------------|------|
| https://goerli.infura.io/...                 | 是   |
...
**区块浏览器**:
| 名称       | URL                        | 标准   |
|------------|----------------------------|--------|
| etherscan  | https://goerli.etherscan.io | EIP3091 |
...

许可证

本项目采用MIT许可证。详情见LICENSE文件。