lowcal-terminal-mcp-server

MCP server that exposes LowCal terminals to MCP clients such as Cursor and Claude Desktop. It surfaces each terminal's profile name, directory, environment variables, tags, status, and a snapshot of recent output — read-only.

It discovers the running LowCal app's local HTTP port from <config_dir>/mcp-port and proxies read-only requests to the app's /mcp/... routes. LowCal must be running for the server to return data.

Usage

Add to your MCP client config (Cursor ~/.cursor/mcp.json, Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "lowcal-terminals": {
      "command": "npx",
      "args": ["-y", "lowcal-terminal-mcp-server"]
    }
  }
}

If you run LowCal with a custom config dir, pass it through so the server finds the matching mcp-port:

{
  "mcpServers": {
    "lowcal-terminals": {
      "command": "npx",
      "args": ["-y", "lowcal-terminal-mcp-server"],
      "env": { "LOWCAL_CONFIG_DIR": "/your/config/dir" }
    }
  }
}

Exposes

• Tools: list_terminals, get_terminal_output({ id, bytes? }).
• Resources: one terminal://<id> per terminal (metadata + recent output).

Requirements

• Node.js 18+ (uses global fetch).
• A running LowCal app.