eips-mcp

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.