Jumpshell MCP Server

Jumpshell exposes module functions as MCP tools over stdio so chat agents can call them directly.

Canonical Paths

  • Runtime server script: src/pwsh/mcp/server.ps1
  • MCP config installer script: src/pwsh/mcp/Install-Mcp.ps1
  • Module MCP management functions: src/pwsh/Mcp.ps1
  • MCP template used by extension packaging: mcps/jumpshell.json

Legacy root-level mcp/ compatibility files were removed.

Setup Paths

Run command:

  • Jumpshell: Install MCP Configuration

Relevant extension settings:

  • jumpshell.installMcpOnSkillsInstall
  • jumpshell.mcpConfigScope (user or workspace)
  • jumpshell.workspaceMcpDirectory (auto, vscode, or cursor)
  • jumpshell.moduleRootPath (optional explicit module/repo path)

Option B: Module command 

Import-Module .\Jumpshell.psd1 -Force
Install-JumpshellMcp -Scope User
# or
Install-JumpshellMcp -Scope Workspace

Option C: Direct script 

pwsh ./src/pwsh/mcp/Install-Mcp.ps1 -ModuleRoot (Resolve-Path .) -Scope User

Runtime Lifecycle Commands 

Import-Module .\Jumpshell.psd1 -Force

Get-JumpshellMcp
Start-JumpshellMcpServer
Stop-JumpshellMcpServer -Force

Autostart Behavior

On module import, Jumpshell attempts:

  • Start-JumpshellMcpServer -OnImport -Quiet

Autostart is skipped when:

  • JUMPSHELL_MCP_DISABLE_AUTOSTART=1
  • JUMPSHELL_MCP_SERVER_MODE=1

Disable autostart for a session:

$env:JUMPSHELL_MCP_AUTOSTART = '0'

Config Shape

Template file mcps/jumpshell.json contains:

  • servers.jumpshell.type = stdio
  • command = pwsh
  • args for -File ${serverScript} and -ModuleRoot ${moduleRoot}
  • environment values:
    • JUMPSHELL_MCP_DISABLE_AUTOSTART=1
    • TERM_PROGRAM=mcp

Logs and State

State/log paths are written under Jumpshell runtime directory:

  • ~/.jumpshell/mcp/server-state.json
  • ~/.jumpshell/mcp/server.stdout.log
  • ~/.jumpshell/mcp/server.stderr.log

Troubleshooting

  1. Validate module path resolution:
Import-Module .\Jumpshell.psd1 -Force
Get-JumpshellMcp | Format-List ModuleRoot,ServerScript,IsRunning
  1. Reinstall config:
Install-JumpshellMcp -Scope User
  1. Restart process and inspect logs:
Stop-JumpshellMcpServer -Force
Start-JumpshellMcpServer
Get-Content ~/.jumpshell/mcp/server.stderr.log -Tail 200
  1. In editor, verify server entry exists (jumpshell) and reset cached tools if needed.