LmsPs — LM Studio PowerShell MCP Server

A minimal, environment‑driven MCP server that exposes a persistent PowerShell session to LM Studio. It keeps a single pwsh.exe/powershell.exe process alive and offers tools to run commands, manage cwd, and get/set env vars. Responses to the client are trimmed (default 500 chars) while full I/O is logged.

Features

• Tools: ps.run, ps.cd, ps.cwd, ps.reset, ps.env_get, ps.env_set

• Persistent PowerShell between calls (stateful session)

• 500‑char response trim to the client; full logs on disk

• All paths/config via environment variables (no hardcoded paths)

Install (dev)

Run (stdio)

• From WSL (recommended by LM Studio):

• Or directly (Windows):

Environment variables

• LMSPS_PWSH — PowerShell executable (default pwsh.exe, fallback powershell.exe)

• LMSPS_PWSH_FALLBACK — override fallback exe if needed

• LMSPS_LOGDIR — log directory (default: <repo>/logs)

• LMSPS_TRIM_CHARS — max characters returned to client (default: 500)

• LMSPS_TIMEOUT_SEC — per‑call timeout in seconds (default: 30)

LM Studio configuration example

Add to your LM Studio settings JSON:

Smoke test (from LM Studio)

• ps.run → Get-Process | Select-Object -First 3

• ps.cwd → should show current location

• ps.cd → change to a test directory and re‑run ps.cwd

• ps.env_set/ps.env_get → write/read a temp environment variable

• Re‑run ps.run to confirm session persistence

Logs

• Full request/response JSON lines are appended to LMSPS_LOGDIR/lmsps_server.log.

Repo layout

• src/lmsps/server.py — MCP server implementation

• scripts/start_ps_mcp_stdio.sh — stdio launcher (used by LM Studio)

• logs/ — default log directory (overridable via LMSPS_LOGDIR)

License

MIT