python-session-mcp

Ejecuta Python en una sesión que permanece viva y expónela a clientes LLM a través del Model Context Protocol.

Autor: Dr Merwan Roudane

Qué lo hace diferente

La sesión persiste. Un DataFrame cargado en una llamada sigue ahí en la siguiente, de modo que un análisis se construye por pasos en lugar de reenviarse completo cada vez.

Tu intérprete, no el del servidor. El servidor puede estar instalado bajo un Python básico sin pandas. El intérprete que ejecuta tu código se elige por separado: se prefiere una instalación de conda o Anaconda cuando está presente, y PYTHON_MCP_INTERPRETER la anula.

Un fallo cuesta un proceso. El código se ejecuta en un worker, no en el servidor. Agota la memoria, llama a sys.exit, provoca un fallo en una extensión C: el worker se reemplaza y el servidor continúa. También mantiene el código de usuario alejado del stdin del servidor, que bajo MCP es el propio flujo JSON-RPC.

Related MCP server: mcp-python-repl

Instalación

pip install python-session-mcp

Uso como biblioteca

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

Una expresión final se muestra como lo haría un REPL, así que df.head() por sí solo muestra el frame sin print().

Uso del servidor MCP

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

Herramientas

Sesión

Ejecución de código

Datos

Estimación

Gráficos

Errores

Los fallos nombran la excepción y la línea de tu código, y dejan la sesión intacta:

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

Cualquier cosa impresa antes del fallo se informa junto con él, ya que esa salida suele ser lo que explica el fallo.

Figuras

Un gráfico no puede volver como texto. Dibújalo y luego guárdalo:

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

Vale la pena saber

• El intérprete es independiente del del servidor. Comprueba python_status antes de confiar en que un paquete esté ahí.

• El estado es una conveniencia y un peligro. Los nombres persisten, así que una variable obsoleta de un paso anterior puede alimentar silenciosamente a una posterior. Usa reset_namespace al empezar algo nuevo.

• run_python ejecuta lo que se le dé, en tu entorno, con tu acceso a archivos. Ese es su propósito, y vale la pena ser deliberado al respecto.

• La expresión final se repite. Un DataFrame largo se imprimirá completo a menos que lo dividas.

Pruebas

python tests/test_live.py     # 41 tests

Cubren la persistencia, el informe de errores con números de línea, los viajes de ida y vuelta JSON, la escritura de figuras, la recuperación después de que el código de usuario mate al worker por completo, y cada herramienta de datos y estimación contra datos generados con coeficientes conocidos.

Comprobado contra EViews con los mismos datos, la regresión coincide en cada dígito impreso: coeficientes, R-cuadrado, Durbin-Watson, y las estadísticas de Breusch-Godfrey y Jarque-Bera por igual.

Licencia

MIT. Copyright (c) 2026 Merwan Roudane.