Python Local

Un entorno REPL interactivo de Python con historial de sesión persistente.

Documentación

python_local MCP Server

Un servidor MCP que proporciona un entorno interactivo de REPL (Read-Eval-Print Loop) de Python.

Componentes

Recursos

El servidor proporciona acceso al historial de sesiones de REPL:

  • Esquema de URI personalizado repl:// para acceder al historial de sesiones
  • El historial de cada sesión se puede ver como un recurso de texto/plano
  • El historial muestra el código de entrada y la salida correspondiente para cada ejecución

Herramientas

El servidor implementa una herramienta:

  • python_repl: Ejecuta código Python en una sesión persistente
    • Toma code (código Python a ejecutar) y session_id como argumentos requeridos
    • Mantiene un estado separado para cada sesión
    • Soporta tanto expresiones como declaraciones
    • Captura y devuelve la salida de stdout/stderr

Configuración

Instalación

Claude Desktop

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración de servidores no publicados en desarrollo ```json "mcpServers": { "python_local": { "command": "uv", "args": [ "--directory", "/path/to/python_local", "run", "python_local" ] } } ```
Configuración de servidores publicados ```json "mcpServers": { "python_local": { "command": "uvx", "args": [ "python_local" ] } } ```

Desarrollo

Construcción y Publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar el lockfile:
uv sync
  1. Construir distribuciones del paquete:
uv build

Esto creará distribuciones de fuente y wheel en el directorio dist/.

  1. Publicar en PyPI:
uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puedes lanzar el Inspector MCP mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/python_local run python-local

Al lanzarlo, el Inspector mostrará una URL que puedes acceder en tu navegador para comenzar a depurar.