🧠 Проект литейного МКП

Этот проект представляет собой сервер Model Context Protocol (MCP), разработанный для взаимодействия с инструментами Foundry. Он предоставляет набор инструментов и утилит для управления проектами Foundry, запуска тестов, построения контрактов и многого другого.

📂 Структура проекта

pyproject.toml       # Project configuration file
README.md            # Project documentation
uv.lock              # Dependency lock file
LLM/                 # Documentation and SDK usage
src/eth_wh_mcp/      # Source code for the MCP server

Related MCP server: AMOCA Solana MCP Server

🚀 Особенности

• Создание проектов Foundry : инициализация новых проектов Foundry.

• Контракты сборки : компилируйте контракты Solidity с различными опциями.

• Запуск тестов : выполнение тестов с подробной конфигурацией.

• Проверка контрактов : извлечение ABI, байт-кода и других метаданных.

• Запустить скрипты : выполнить скрипты Solidity.

• Запуск локальных узлов : запуск Anvil или Chisel для локальной разработки Ethereum.

• Расширенные команды Cast : выполнение команд, связанных с Ethereum, с помощью cast .

🛠️ Установка

Установка через Smithery

Чтобы автоматически установить Foundry MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @lhemerly/foundry-mcp --client claude

Ручная установка

1. Клонируйте репозиторий:

   git clone <repository-url>

2. Убедитесь, что литейные инструменты ( forge , cast , anvil и т. д.) установлены и доступны в вашем PATH.

🏗️ Использование

Запуск сервера MCP

Чтобы запустить сервер MCP:

python src/eth_wh_mcp/main.py

Доступные инструменты

На сервере MCP доступны следующие инструменты:

• create_project : Инициализация нового проекта Foundry.

• build_project : Сборка текущего проекта Foundry.

• test_project : Запуск тестов в проекте Foundry.

• clone_contract : Клонировать контракт из Etherscan.

• run_script : Выполнить скрипт Solidity.

• run_cast_command : Выполнить команду cast .

• start_anvil_with_options : Запустить локальный узел Ethereum Anvil.

• start_chisel_with_options : Запустить Chisel Solidity REPL.

• inspect_contract : проверка метаданных контракта.

• snapshot_project : создание моментального снимка потребления газа.

• coverage_project : Отображение тестового покрытия.

📖 Документация

MCP Python SDK

Подробную информацию об использовании MCP Python SDK, включая создание сервера, инструменты, подсказки и обработку контекста, можно найти в файле LLM/python-mcp-sdk.md.

🧪 Развитие

Локальная отладка

Запустите сервер MCP в режиме разработки:

mcp dev src/eth_wh_mcp/main.py --with-editable .

Выполнение во время выполнения

Для запуска сервера:

python src/eth_wh_mcp/main.py

📜 Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE.