Lanzakit Tester

Tests de pytest generados por IA, y verificados antes de que los veas.

Lanzakit Tester es un MCP server que lee tu código Python, genera tests con Claude y los ejecuta para confirmar que compilan y pasan. Dejas de revisar tests que ni siquiera corren.

Features

• 🧪 Generación de tests con Claude: analiza tu código y produce tests pytest listos para usar.
• ✅ Validación automática: verifica la sintaxis y ejecuta pytest antes de entregarte el resultado.
• 🔌 MCP nativo: funciona con Claude Desktop y cualquier cliente compatible con MCP.
• 🌳 Análisis con AST: entiende funciones, clases y firmas antes de armar el prompt.
• 🇪🇸 Español-first: comentarios de los tests y documentación en español.
• 🔓 Open source: licencia MIT, sin lock-in.

Requisitos

• Python 3.11+
• Una API key de Anthropic (ANTHROPIC_API_KEY)
• Acceso al modelo claude-sonnet-5

Instalación

pip install lanzakit-tester
echo "ANTHROPIC_API_KEY=tu_api_key" > .env

El archivo .env contiene tu API key. Nunca lo subas a git.

Opción A: Vía Claude Desktop (MCP config)

Agrega el server a tu claude_desktop_config.json:

{
  "mcpServers": {
    "lanzakit-tester": {
      "command": "lanzakit-tester"
    }
  }
}

Reinicia Claude Desktop y las 3 tools aparecerán disponibles.

Opción B: Vía Python

Sin cliente MCP, puedes invocar las tools directamente desde Python:

python -c "from lanzakit_tester import generate_and_validate_tests; print(generate_and_validate_tests('/ruta/a/tu_archivo.py')['summary'])"

Para contribuir

git clone https://github.com/lanzakit/starter-kit.git
cd starter-kit
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"

Uso

Tienes un archivo hola_claude.py (ver examples/hola_claude.py, versión simplificada):

import os

from anthropic import Anthropic
from dotenv import load_dotenv

load_dotenv()
client = Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))


def saludar():
    message = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=512,
        messages=[{"role": "user", "content": "Hola Claude"}]
    )
    print(message.content[0].text)

Desde Claude Desktop, pídele:

Genera y valida tests para /ruta/a/tu_archivo.py

Claude llama a la tool generate_and_validate_tests y obtienes un resumen como este:

✅ 8 tests generados y pasaron. Guardado en: /ruta/a/test_tu_archivo.py

El archivo test_tu_archivo.py queda junto a tu código, listo para correr con pytest.

Tools disponibles

Cómo funciona

código .py
   │
   ▼
análisis AST  ──►  prompt a Claude  ──►  tests generados
                                              │
                                              ▼
                      resultado  ◄──  ejecución pytest  ◄──  validación sintáctica

1. Lee tu archivo y extrae su estructura con AST.
2. Arma un prompt con el código y su contexto, y se lo envía a Claude (claude-sonnet-5).
3. Limpia la respuesta (por ejemplo, quita markdown fences).
4. Valida que los tests tengan sintaxis Python correcta.
5. Guarda el archivo y ejecuta pytest.
6. Devuelve un resumen: cuántos pasaron, fallaron o dieron error.

Roadmap

• 3 tools funcionales
• Validación end-to-end
• Empaquetado como paquete pip
• Publicación en PyPI
• Landing en lanzakit.dev
• Soporte para más frameworks de testing

Contribuir

¿Encontraste un bug o tienes una idea? Abre un issue o envía un PR. Lee CONTRIBUTING.md para conocer el flujo de trabajo.

Licencia

Distribuido bajo licencia MIT. Consulta el archivo LICENSE.

@lanzakit · Construido en Bolivia 🇧🇴 para devs hispanohablantes