Celo MCP Setup Guide

Celo MCP Server Setup Guide

Guía completa de instalación del Celo Composer Kit MCP Server en macOS

Esta guía documenta el proceso completo de instalación del servidor MCP de Celo Composer Kit, incluyendo todos los problemas encontrados y sus soluciones.

Requisitos Previos

• macOS 12+ (funciona con versiones anteriores pero sin soporte oficial de Homebrew)
• Python 3.11+ (verificamos con Python 3.13.7)
• Homebrew (para algunas instalaciones)
• Conocimientos básicos de terminal y línea de comandos

Problemas Identificados y Soluciones

1. Falta del comando realpath

Problema: El comando realpath no está disponible por defecto en macOS, pero es requerido por uvx.

Error típico:

realpath: command not found

Solución: Crear un script personalizado de realpath usando Python:

# Crear el script
cat > ~/.local/bin/realpath > ~/.zshrc

Paso 4: Instalar pipx

brew install pipx

Paso 5: Crear script realpath personalizado

mkdir -p ~/.local/bin
cat > ~/.local/bin/realpath /dev/null || echo "MCP server installed correctly"

Troubleshooting

Error: "realpath: command not found"

Solución: Asegúrate de que el script personalizado de realpath esté instalado y en tu PATH.

Error: "python: No such file or directory"

Solución: Verifica que UV esté usando el PATH correcto y que realpath funcione.

Error: "externally-managed-environment"

Solución: Usa pipx en lugar de pip para instalaciones globales.

Problemas con macOS 12 o anterior

Solución: Los warnings de Homebrew son normales. Las instalaciones funcionarán pero sin soporte oficial.

Comandos de Ejemplo

Una vez configurado en tu IDE, puedes probar:

"What Composer Kit components are available?"
"Show me how to create a payment component"
"Search for wallet-related components"
"Get installation guide for npm"
"Show me examples of the Balance component"

Recursos Adicionales

• Documentación oficial de Celo MCP
• Repositorio de Composer Kit MCP
• Documentación de UV
• Model Context Protocol

Contribuciones

Si encuentras problemas adicionales o tienes mejoras para esta guía, por favor abre un issue o envía un pull request.

Fecha de creación: Agosto 2025 Probado en: macOS 12 (Monterey) con Python 3.13.7