Eips MCP

🚀 EIPs MCP

An MCP server that offers semantically related Ethereum Improvement Proposals (EIPs) to AI agents.

🚀 Quick Start

The EIPs MCP server is designed to provide semantically related Ethereum Improvement Proposals (EIPs) to AI agents. It uses vector embeddings for semantic search and supports processing EIP markdown files.

✨ Features

• Semantic Search: Leverages vector embeddings to conduct accurate, context - aware searches across EIP documents.
• Markdown Support: Processes EIP markdown files by chunking them 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 Examples

Basic Usage

The server exposes a single MCP tool, search, which accepts a query string and returns relevant EIP content. 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.