EIPs MCP

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:

License

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