python-session-mcp

Запускайте Python в сеансе, который остаётся активным, и открывайте его для LLM-клиентов через Model Context Protocol.

Автор: д-р Merwan Roudane

В чём отличие

Сеанс сохраняется. DataFrame, загруженный в одном вызове, остаётся на месте и в следующем, так что анализ строится по шагам, а не пересылается целиком каждый раз.

Ваш интерпретатор, а не серверный. Сервер вполне может быть установлен в голый Python без pandas. Интерпретатор, выполняющий ваш код, выбирается отдельно: при наличии предпочтение отдаётся установке conda или Anaconda, а PYTHON_MCP_INTERPRETER переопределяет это.

Сбой стоит одного процесса. Код выполняется в воркере, а не на сервере. Исчерпайте память, вызовите sys.exit, уроните C-расширение — воркер будет заменён, а сервер продолжит работу. Это также не подпускает пользовательский код к stdin сервера, который в MCP является самим потоком JSON-RPC.

Related MCP server: mcp-python-repl

Установка

pip install python-session-mcp

Использование в качестве библиотеки

from python_mcp import PythonRunner

with PythonRunner() as py:
    py.run("import pandas as pd, statsmodels.api as sm")
    py.run("df = pd.read_csv('macro.csv')")
    print(py.run("df.describe()"))

    py.run("m = sm.OLS(df['y'], sm.add_constant(df[['x','z']])).fit()")
    print(py.run("m.summary()"))
    print(py.value("m.params.to_dict()"))    # a real Python dict

Финальное выражение выводится так же, как в REPL, поэтому одного df.head() достаточно для отображения таблицы без print().

Использование MCP-сервера

{
  "mcpServers": {
    "python": {
      "command": "python-session-mcp",
      "env": { "PYTHON_MCP_INTERPRETER": "C:\\Users\\you\\anaconda3\\python.exe" }
    }
  }
}

Инструменты

Сессия

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

Данные

Оценивание

Графики

Ошибки

При сбое называются исключение и строка вашего кода, а сессия остаётся нетронутой:

Python error: NameError on line 2: name 'undefined_name' is not defined

Всё, что было выведено до сбоя, сообщается вместе с ним, поскольку именно этот вывод часто объясняет причину.

Графики

График нельзя вернуть как текст. Нарисуйте его, а затем сохраните:

py.run("import matplotlib; matplotlib.use('Agg')")
py.run("import matplotlib.pyplot as plt; plt.plot(df['x'], df['y'], 'o')")
py.save_figure("figures/scatter.png")     # missing folders are created

Полезно знать

• Интерпретатор отделён от серверного. Проверяйте python_status, прежде чем рассчитывать на наличие пакета.

• Состояние — это и удобство, и опасность. Имена сохраняются, поэтому устаревшая переменная с предыдущего шага может незаметно повлиять на следующий. Используйте reset_namespace перед началом нового.

• run_python выполняет всё, что ему передано, в вашем окружении и с вашим доступом к файлам. В этом его суть, и к этому стоит относиться осознанно.

• Финальное выражение выводится на экран. Длинный DataFrame напечатается целиком, если его не обрезать.

Тесты

python tests/test_live.py     # 41 tests

Они охватывают сохранение состояния, сообщения об ошибках с номерами строк, JSON-сериализацию, сохранение графиков, восстановление после того, как пользовательский код полностью убивает воркер, а также каждый инструмент работы с данными и оценивания на сгенерированных данных с известными коэффициентами.

При проверке на тех же данных в EViews регрессия совпадает до каждой напечатанной цифры — коэффициенты, R-квадрат, Дарбин-Уотсон, а также статистики Бреуша-Годфри и Харке-Бера.

Лицензия

MIT. Авторское право (c) 2026 Merwan Roudane.