local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows interaction with Python environments, execution of Python code, management of packages, and Python-related file operations including reading, writing, and debugging Python files.

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:

pip install mcp-python-interpreter

O con uv:

uv install mcp-python-interpreter

Uso con Claude Desktop

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

{
  "mcpServers": {
    "mcp-python-interpreter": {
        "command": "uvx",
        "args": [
            "mcp-python-interpreter",
            "--dir",
            "/path/to/your/work/dir",
            "--python-path",
            "/path/to/your/python"
        ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

Para Windows:

{
  "mcpServers": {
    "python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "C:\\path\\to\\your\\working\\directory",
        "--python-path",
        "/path/to/your/python"
      ],
        "env": {
            "MCP_ALLOW_SYSTEM_ACCESS": 0
        },
    }
  }
}

Reiniciar Claude Desktop
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)

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

Un servidor de protocolo de contexto de modelo que permite a los LLM interactuar con entornos Python, ejecutar código y administrar archivos dentro de un directorio de trabajo específico.

MCP Python Interpreter