jan-terminal-mcp

Jan AI has no native terminal or code execution. This gives it that.

An MCP server that gives your local Jan model real hands on your machine — run shell commands, execute code in 14 languages, read/write files, and use git. All locally, all private.

Includes a fine-tuned 4B model trained specifically to call these tools reliably instead of just describing what it would do.

Tools

Tool	Description
run_shell	Run any PowerShell command
git	Run git commands in any repo
read_file	Read any file's contents
write_file	Write or overwrite a file
list_dir	List files and folders in a directory
edit_file	Replace a specific substring in a file — smarter than rewriting the whole thing
run_python	Execute Python code directly and return output
run_cpp	Compile and run C++ code (g++), returns errors + output
run_code	Execute code in any language — Python, JavaScript, TypeScript, Java, C++, C#, Go, Rust, Ruby, PHP, R, Kotlin, Swift, MATLAB

Fine-tuned model

AItrainer1/jancoder-4b-gguf a 4B model fine-tuned via QLoRA on tool-use conversations generated specifically for this tool schema.

Stock models at this size tend to describe what they'd do rather than actually calling tools. This model was trained to call them correctly and consistently.

Drop the GGUF into Jan and it works out of the box with this MCP server.

The Kaggle training notebook is at kaggle_finetune.ipynb.

Install

pip install jan-terminal-mcp

Setup in Jan AI

1. Open Jan, Settings, MCP Servers
2. Click Add and paste this config:

{
  "jan-terminal": {
    "command": "jan-terminal-mcp",
    "args": [],
    "env": {},
    "active": true
  }
}

Or edit %APPDATA%\Jan\data\mcp_config.json directly and add the block above inside "mcpServers".

3. Restart Jan - the server appears as Jan-Terminal with a green dot.

Requirements

• Windows (PowerShell required for run_shell)
• Python 3.10+
• Jan AI v0.7.9+
• pip install mcp>=2.0.0

Bugs

Report bugs and stuff to ISSUE

License

MIT