Ethereum Improvement Proposals (EIPs)

An MCP server for providing semantically related Ethereum Improvement Proposals (EIPs) to AI agents.

Features

• Semantic Search: Utilizes vector embeddings for accurate, context-aware search across EIP documents.
• Markdown Support: Processes EIP markdown files with chunking for efficient storage and retrieval.

Installation

Prerequisites

• Python 3.10+
• uv (recommended) or pip for dependency management

Setup

1. Clone the Repository:

   git clone --recursive-submodules https://github.com/kukapay/eips-mcp.git
   cd eips-mcp
   

2. Install the Dependencies (recommended):

   uv sync
   

3. Load EIP Documents: Use the provided load_eips.py script to automatically fetch and process EIPs:

   uv run load_eips.py
   

4. Installing to Claude Desktop:

   Install the server as a Claude Desktop application:

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

   Configuration file as a reference:

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

   Replace /path/to/eips-mcp with your actual installation path.

Usage

The server exposes a single MCP tool, search, which accepts a query string and returns relevant EIP content. Example usage in an MCP-compatible client:

You can use natural language prompts such as:

• "Search for EIPs related to CREATE2"
• "Find EIPs about contract deployment opcodes"
• "EIPs discussing CREATE2 implementation details"

The tool processes these queries and returns up to 5 relevant EIP document chunks, formatted with separators for clarity.

When searching for "CREATE2" using the search tool, the output might look like:

--------------------eip-1014.md--------------------
# EIP-1014: Skinny CREATE2
**Abstract**: This EIP adds a new opcode at 0xf5, CREATE2, which allows for deterministic address generation...
...
--------------------eip-1014.md--------------------
**Motivation**: The CREATE2 opcode enables predictable contract addresses, which is useful for...
...

License

This project is licensed under the MIT License. See the LICENSE file for details.