EIPs MCP

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

GitHub License

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

Clone the Repository:

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

Install the Dependencies (recommended):
```
uv sync
```
Load EIP Documents: Use the provided load_eips.py script to automatically fetch and process EIPs:
```
uv run load_eips.py
```

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.

Ethereum Improvement Proposals (EIPs)