Servidor MCP de Python REPL

Este servidor MCP proporciona un REPL de Python (bucle de lectura-evaluación-impresión) como herramienta. Permite la ejecución de código Python a través del protocolo MCP con una sesión persistente.

Configuración

¡No se necesita configuración! El proyecto utiliza uv para la gestión de dependencias.

Ejecución del servidor

Simplemente ejecuta:

uv run src/python_repl/server.py

Uso con Claude Desktop

Añade esta configuración a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "python-repl": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/python-repl-server",
        "run",
        "mcp_python"
      ]
    }
  }
}

El servidor proporciona tres herramientas:

execute_python: Ejecuta código Python con variables persistentes
- code: El código Python a ejecutar
- reset: Booleano opcional para restablecer la sesión
list_variables: Muestra todas las variables de la sesión actual
install_package: Instala un paquete desde pypi

Ejemplos

Establece una variable:

a = 42

Usa la variable:

print(f"The value is {a}")

Lista todas las variables:

# Use the list_variables tool

Restablece la sesión:

# Use execute_python with reset=true

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una solicitud de extracción (Pull Request). Aquí tienes algunas formas de contribuir:

Reportar errores
Sugerir nuevas funciones
Mejorar la documentación
Añadir casos de prueba
Enviar mejoras de código

Antes de enviar un PR, asegúrate de:

Que tu código siga el estilo existente
Que hayas actualizado la documentación según sea necesario
¿Quizás escribir algunas pruebas?

Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Python REPL

Documentación