🧠 Proyecto MCP de Fundición

Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) diseñado para interactuar con las herramientas de Foundry. Proporciona un conjunto de herramientas y utilidades para gestionar proyectos de Foundry, ejecutar pruebas, crear contratos y mucho más.

📂 Estructura del proyecto

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: MCP Ethers Wallet

🚀 Características

• Crear proyectos de Foundry : inicializa nuevos proyectos de Foundry.

• Crear contratos : compila contratos de Solidity con varias opciones.

• Ejecutar pruebas : ejecuta pruebas con configuración detallada.

• Inspeccionar contratos : recupera ABI, código de bytes y otros metadatos.

• Ejecutar scripts : ejecuta scripts de Solidity.

• Iniciar nodos locales : inicie Anvil o Chisel para el desarrollo local de Ethereum.

• Comandos de cast avanzados : ejecuta comandos relacionados con Ethereum usando cast .

🛠️ Instalación

1. Clonar el repositorio:

   git clone <repository-url>

2. Asegúrese de que las herramientas de fundición ( forge , cast , anvil , etc.) estén instaladas y disponibles en su PATH.

🏗️ Uso

Ejecución del servidor MCP

Para iniciar el servidor MCP:

python src/eth_wh_mcp/main.py

Herramientas disponibles

Las siguientes herramientas están disponibles en el servidor MCP:

• create_project : Inicializa un nuevo proyecto de Foundry.

• build_project : Construye el proyecto Foundry actual.

• test_project : Ejecuta pruebas en el proyecto Foundry.

• clone_contract : Clona un contrato de Etherscan.

• run_script : Ejecuta un script de Solidity.

• run_cast_command : Ejecuta un comando cast .

• start_anvil_with_options : Inicia el nodo local de Ethereum de Anvil.

• start_chisel_with_options : Iniciar el REPL de Chisel Solidity.

• inspect_contract : Inspeccionar metadatos del contrato.

• snapshot_project : Crea una instantánea del uso de gas.

• cobertura_proyecto : Muestra la cobertura de la prueba.

📖 Documentación

SDK de Python para MCP

Consulte el archivo LLM/python-mcp-sdk.md para obtener información detallada sobre el uso del SDK de Python de MCP, incluida la construcción del servidor, las herramientas, las indicaciones y el manejo del contexto.

🧪 Desarrollo

Depuración local

Ejecute el servidor MCP en modo de desarrollo:

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

Ejecución en tiempo de ejecución

Para ejecutar el servidor:

python src/eth_wh_mcp/main.py

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.