Mutmut MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para gestionar pruebas de mutación con mutmut . Esta herramienta proporciona un conjunto de API programáticas para ejecutar pruebas de mutación, analizar resultados y mejorar la cobertura de las pruebas en proyectos de Python.

Características

• Ejecute sesiones de prueba de mutación en cualquier módulo o paquete de Python

• Mostrar los resultados generales de las pruebas de mutación y las mutaciones supervivientes

• Sugerir áreas que necesitan una mejor cobertura de pruebas

• Vuelva a ejecutar mutmut en sobrevivientes específicos o en todos los sobrevivientes

• Limpiar la caché de mutmut

• Diseñado para la automatización y la integración con otras herramientas MCP

Instalación

1. Clonar el repositorio:

   git clone https://github.com/wdm0006/mutmut-mcp.git cd mutmut-mcp

2. Instalar dependencias:

   python3 -m venv .venv source .venv/bin/activate pip install -U pip pip install mcp[cli] mutmut

Uso

Puede ejecutar el servidor MCP directamente:

O usar con uv :

API / Herramientas

Las siguientes herramientas están disponibles:

• run_mutmut(target, test_command="pytest", options="", venv_path=None) – Ejecutar pruebas de mutación

• show_results(venv_path=None) – Mostrar resultados generales

• show_survivors(venv_path=None) – Lista de mutaciones supervivientes

• generate_test_suggestion(venv_path=None) – Sugerir áreas que necesitan una mejor cobertura de pruebas

• rerun_mutmut_on_survivor(mutation_id=None, venv_path=None) – Reejecutar mutmut en los sobrevivientes

• clean_mutmut_cache(venv_path=None) – Limpiar la caché de mutmut

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulte la LICENCIA para más detalles.