返回 MCP 目录
public公开dns本地运行

eips-mcp

一个MCP服务器,通过语义搜索为AI代理提供相关的以太坊改进提案(EIP)内容,支持Markdown文档处理和向量化检索。

article

README

🚀 EIPs MCP

EIPs MCP是一个MCP服务器,旨在为AI智能体提供语义相关的以太坊改进提案(EIPs)。

GitHub License Python Version Status

✨ 主要特性

  • 语义搜索:利用向量嵌入技术,在EIP文档中进行准确的上下文感知搜索。
  • Markdown支持:对EIP的Markdown文件进行分块处理,以便高效存储和检索。

📦 安装指南

前提条件

  • Python 3.10 及以上版本
  • uv(推荐)或pip用于依赖管理

安装步骤

  1. 克隆仓库

    git clone --recursive-submodules https://github.com/kukapay/eips-mcp.git
    cd eips-mcp
    
  2. 安装依赖(推荐):

    uv sync
    
  3. 加载EIP文档: 使用提供的load_eips.py脚本自动获取和处理EIPs:

    uv run load_eips.py
    
  4. 安装到Claude桌面应用: 将服务器作为Claude桌面应用程序进行安装:

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

    配置文件示例如下:

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

    请将/path/to/eips-mcp替换为实际的安装路径。

💻 使用示例

基础用法

服务器公开了一个名为search的MCP工具,该工具接受一个查询字符串并返回相关的EIP内容。在兼容MCP的客户端中使用示例如下:

你可以使用自然语言进行查询,例如:

  • "搜索与CREATE2相关的EIPs"
  • "查找关于合约部署操作码的EIPs"
  • "查找讨论CREATE2实现细节的EIPs"

该工具会处理这些查询,并返回最多5个相关的EIP文档块,为了清晰起见,会使用分隔符进行格式化。

当使用search工具搜索"CREATE2"时,输出可能如下所示:

--------------------eip-1014.md--------------------
# EIP-1014: Skinny CREATE2
**摘要**:本EIP在0xf5处添加了一个新的操作码CREATE2,用于实现确定性地址生成...
...
--------------------eip-1014.md--------------------
**动机**:CREATE2操作码可实现可预测的合约地址,这在...方面很有用
...

📄 许可证

本项目采用MIT许可证。有关详细信息,请参阅LICENSE文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端