MCP Python Interpreter

Intérprete de Python MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar con entornos Python, leer y escribir archivos, ejecutar código Python y administrar flujos de trabajo de desarrollo.

Características

• Gestión del entorno : enumerar y utilizar diferentes entornos de Python (sistema y conda)
• Ejecución de código : ejecute código o scripts de Python en cualquier entorno disponible
• Gestión de paquetes : enumera los paquetes instalados e instala los nuevos
• Operaciones de archivo :
  • Leer archivos de cualquier tipo (texto, código fuente, binario)
  • Escribir archivos de texto y binarios
• Indicaciones de Python : plantillas para tareas comunes de Python, como creación y depuración de funciones

Instalación

Puede instalar el intérprete de Python de MCP usando pip:

O con uv:

Uso con Claude Desktop

1. Instalar Claude Desktop
2. Abra Claude Desktop, haga clic en el menú y luego en Configuración
3. Vaya a la pestaña Desarrollador y haga clic en "Editar configuración".
4. Agregue lo siguiente a su claude_desktop_config.json :

Para Windows:

5. Reiniciar Claude Desktop
6. Ahora debería ver el ícono de herramientas MCP en la interfaz de chat

El parámetro --dir es obligatorio y especifica dónde se guardarán y ejecutarán todos los archivos. Esto ayuda a mantener la seguridad al aislar el servidor MCP en un directorio específico.

Prerrequisitos

• Asegúrate de tener instalado uv . Si no es así, instálalo usando:
  curl -LsSf https://astral.sh/uv/install.sh | sh
• Para Windows:
  powershell -ExecutionPolicy Bypass -Command "iwr -useb https://astral.sh/uv/install.ps1 | iex"

Herramientas disponibles

El intérprete de Python proporciona las siguientes herramientas:

Gestión del medio ambiente y de los paquetes

• list_python_environments : enumera todos los entornos de Python disponibles (sistema y conda)
• list_installed_packages : enumera los paquetes instalados en un entorno específico
• install_package : instala un paquete de Python en un entorno específico

Ejecución de código

• run_python_code : Ejecuta código Python en un entorno específico
• run_python_file : ejecuta un archivo Python en un entorno específico

Operaciones con archivos

• read_file : Lee el contenido de cualquier tipo de archivo, con límites de tamaño y seguridad
  • Admite archivos de texto con resaltado de sintaxis
  • Muestra la representación hexadecimal de archivos binarios
• write_file : Crea o sobrescribe archivos con texto o contenido binario
• write_python_file : Crea o sobrescribe un archivo Python específicamente
• list_directory : enumera los archivos de Python en un directorio

Recursos disponibles

• python://environments : Lista todos los entornos de Python disponibles
• python://packages/{env_name} : enumera los paquetes instalados para un entorno específico
• python://file/{file_path} : Obtener el contenido de un archivo Python
• python://directory/{directory_path} : enumera todos los archivos de Python en un directorio

Indicaciones

• python_function_template : Genera una plantilla para una función de Python
• refactor_python_code : Ayuda a refactorizar el código Python
• debug_python_error : Ayuda a depurar un error de Python

Ejemplo de uso

A continuación se muestran algunos ejemplos de lo que puedes pedirle a Claude que haga con este servidor MCP:

• "Muéstrame todos los entornos de Python disponibles en mi sistema"
• Ejecute este código Python en mi entorno conda-base: print('¡Hola, mundo!')
• "Crea un nuevo archivo Python llamado 'hello.py' con una función que diga hola"
• "Leer el contenido de mi archivo 'data.json'"
• "Escribe un nuevo archivo de configuración con estos ajustes..."
• "Enumerar todos los paquetes instalados en el entorno Python de mi sistema"
• Instalar el paquete de solicitudes en el entorno Python de mi sistema.
• Ejecute data_analysis.py con estos argumentos: --input=data.csv --output=results.csv

Capacidades de manejo de archivos

El intérprete de Python de MCP ahora admite operaciones de archivos integrales:

• Lee archivos de texto y binarios de hasta 1 MB
• Escribir archivos de texto y binarios
• Resaltado de sintaxis para archivos de código fuente
• Representación hexadecimal para archivos binarios
• Seguridad estricta de la ruta de archivo (solo dentro del directorio de trabajo)

Consideraciones de seguridad

Este servidor MCP tiene acceso a sus entornos Python y a su sistema de archivos. Sus principales características de seguridad incluyen:

• Directorio de trabajo aislado
• Límites de tamaño de archivo
• Escrituras evitadas fuera del directorio de trabajo
• Protección de sobrescritura explícita

Tenga siempre cuidado al ejecutar código o realizar operaciones con archivos que no comprenda completamente.

Licencia

Instituto Tecnológico de Massachusetts (MIT)