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)