Интерпретатор MCP Python

Сервер протокола контекста модели (MCP), который позволяет LLM взаимодействовать со средами Python, читать и записывать файлы, выполнять код Python и управлять рабочими процессами разработки.

Функции

• Управление средой : список и использование различных сред Python (system и conda)

• Выполнение кода : запуск кода или скриптов Python в любой доступной среде.

• Управление пакетами : список установленных пакетов и установка новых.

• Операции с файлами :

  • Чтение файлов любого типа (текст, исходный код, двоичные)

  • Запись текстовых и двоичных файлов

• Python Prompts : шаблоны для типичных задач Python, таких как создание и отладка функций.

Related MCP server: MCP Python Toolbox

Установка

Установить интерпретатор MCP Python можно с помощью pip:

pip install mcp-python-interpreter

Или с помощью uv:

uv install mcp-python-interpreter

Использование с Claude Desktop

1. Установить Claude Desktop

2. Откройте Claude Desktop, нажмите на меню, затем на «Настройки».

3. Перейдите на вкладку «Разработчик» и нажмите «Изменить конфигурацию».

4. Добавьте следующее в ваш 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
        },
    }
  }
}

Для 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
        },
    }
  }
}

5. Перезагрузить рабочий стол Клода

6. Теперь вы должны увидеть значок инструментов MCP в интерфейсе чата.

Параметр --dir является обязательным и указывает, где будут сохранены и выполнены все файлы. Это помогает поддерживать безопасность, изолируя сервер MCP в определенном каталоге.

Предпосылки

• Убедитесь, что у вас установлен uv . Если нет, установите его с помощью:

  curl -LsSf https://astral.sh/uv/install.sh | sh

• Для Windows:

  powershell -ExecutionPolicy Bypass -Command "iwr -useb https://astral.sh/uv/install.ps1 | iex"

Доступные инструменты

Интерпретатор Python предоставляет следующие инструменты:

Управление окружающей средой и упаковкой

• list_python_environments : список всех доступных сред Python (system и conda)

• list_installed_packages : Список пакетов, установленных в определенной среде

• install_package : Установить пакет Python в определенной среде

Выполнение кода

• run_python_code : выполнение кода Python в определенной среде

• run_python_file : выполнение файла Python в определенной среде

Операции с файлами

• read_file : Чтение содержимого любого типа файла с ограничениями по размеру и безопасности

  • Поддерживает текстовые файлы с подсветкой синтаксиса.

  • Отображает шестнадцатеричное представление двоичных файлов

• write_file : Создание или перезапись файлов с текстовым или двоичным содержимым

• write_python_file : создать или перезаписать файл Python специально

• list_directory : Список файлов Python в каталоге

Доступные ресурсы

• python://environments : список всех доступных сред Python

• python://packages/{env_name} : список установленных пакетов для определенной среды

• python://file/{file_path} : Получить содержимое файла Python

• python://directory/{directory_path} : список всех файлов Python в каталоге

Подсказки

• python_function_template : создание шаблона для функции Python

• refactor_python_code : Помогите рефакторить код Python

• debug_python_error : Помогите отладить ошибку Python

Пример использования

Вот несколько примеров того, что вы можете попросить Клода сделать с помощью этого сервера MCP:

• «Покажите мне все доступные среды Python в моей системе»

• «Запустите этот код Python в моей среде conda-base: print('Hello, world!')»

• «Создайте новый файл Python с именем hello.py и функцией, которая говорит hello»

• «Прочитайте содержимое моего файла 'data.json'»

• «Запишите новый файл конфигурации с этими настройками...»

• «Вывести список всех пакетов, установленных в моей системной среде Python»

• «Установить пакет requests в моей системной среде Python»

• «Запустите data_analysis.py со следующими аргументами: --input=data.csv --output=results.csv»

Возможности обработки файлов

Интерпретатор MCP Python теперь поддерживает комплексные файловые операции:

• Чтение текстовых и двоичных файлов размером до 1 МБ

• Запись текстовых и двоичных файлов

• Подсветка синтаксиса для файлов исходного кода

• Шестнадцатеричное представление двоичных файлов

• Строгая безопасность пути к файлу (только в пределах рабочего каталога)

Соображения безопасности

Этот сервер MCP имеет доступ к вашим средам Python и файловой системе. Ключевые функции безопасности включают:

• Изолированный рабочий каталог

• Ограничения на размер файла

• Предотвращена запись за пределами рабочего каталога

• Явная защита от перезаписи

Всегда будьте осторожны при запуске кода или файловых операций, которые вы не до конца понимаете.

Лицензия

Массачусетский технологический институт