light-remote-mcpBLOCK
Light Remote MCP turns a Windows or Linux machine into an explicitly authorized remote execution target for ChatGPT, Claude, Codex, and other MCP-capable AI workflows.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Cho ChatGPT Web và AI làm việc trực tiếp trên máy của bạn qua HTTP — không cần mở SSH inbound cho từng máy.
Tiếng Việt · English
Light Remote MCP là một lớp remote execution có kiểm soát dành cho ChatGPT Web, Agent và các mô hình AI khác. Thay vì để AI SSH trực tiếp vào từng VPS/PC, Light Remote đưa filesystem, process, terminal PTY/ConPTY, Git, Docker, system services và nhiều thao tác infra qua một luồng HTTP được gắn đúng device + session + Agent + policy.
Mục tiêu thực tế: thay phần lớn workflow “mở SSH rồi thao tác tay” bằng một kết nối AI có thể audit, cấp quyền theo máy, giữ session bền và thu hồi được.
Beta: 0.9.0-rc.26 là release candidate để test. Hãy bắt đầu với quyền thấp trên máy không critical trước khi bật terminal, sudo/UAC, package manager hoặc system-service permissions.Vì sao Light Remote khác một remote shell thông thường?
- Không cần mở inbound SSH trên leaf client. Windows/Linux/macOS Agent giữ outbound device channel tới Hub.
- Không cần mở terminal để giữ kết nối. Windows chạy background Agent sau tray, Linux chạy systemd, macOS dùng launchd; đóng PowerShell/SSH/browser không làm service biến mất.
- PTY/ConPTY thật. Agent có thể mở shell tương tác, gửi Ctrl-C, resize terminal, chạy installer/TUI
04b6583cb630OBSERVED · 2026-10-12Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add light-remote-direct-plugin-server --env CLIENT_UPDATE_SIGNING_KEY_FILE=${CLIENT_UPDATE_SIGNING_KEY_FILE} --env GPT_OPERATOR_UPDATE_PUBLIC_KEY=${GPT_OPERATOR_UPDATE_PUBLIC_KEY} --env LIGHT_REMOTE_GOOGLE_OAUTH_FILE=${LIGHT_REMOTE_GOOGLE_OAUTH_FILE} --env LIGHT_REMOTE_PLUGIN_OAUTH_LEGACY_CLIENTS_FILE=${LIGHT_REMOTE_PLUGIN_OAUTH_LEGACY_CLIENTS_FILE} -- npx -y [email protected]{
"mcpServers": {
"light-remote-direct-plugin-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CLIENT_UPDATE_SIGNING_KEY_FILE": "${CLIENT_UPDATE_SIGNING_KEY_FILE}",
"GPT_OPERATOR_UPDATE_PUBLIC_KEY": "${GPT_OPERATOR_UPDATE_PUBLIC_KEY}",
"LIGHT_REMOTE_GOOGLE_OAUTH_FILE": "${LIGHT_REMOTE_GOOGLE_OAUTH_FILE}",
"LIGHT_REMOTE_PLUGIN_OAUTH_LEGACY_CLIENTS_FILE": "${LIGHT_REMOTE_PLUGIN_OAUTH_LEGACY_CLIENTS_FILE}"
}
}
}
}Exposed tools (44)
33 read · 10 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
fs_list | read | |
fs_read_text | read | |
fs_search | read | |
git_diff | read | |
git_status | read | |
light_remote_capabilities | read | |
light_remote_close_session | read | |
light_remote_copy_path | read | |
light_remote_delete_path | destructive | |
light_remote_device | read | |
light_remote_devices | read | |
light_remote_edit_block | write | |
light_remote_exec | write | |
light_remote_fleet | read | |
light_remote_hold_session | read | |
light_remote_job | read | |
light_remote_list_directory | read | |
light_remote_make_directory | read | |
light_remote_move_path | write | |
light_remote_open_session | read | |
light_remote_operating_contract | read | |
light_remote_output | read | |
light_remote_process_input | read | |
light_remote_process_list | read | |
light_remote_process_output | read | |
light_remote_process_start | write | |
light_remote_process_stop | write | |
light_remote_read_multiple_files | read | |
light_remote_read_text_file | read | |
light_remote_resume_session | read | |
light_remote_run_signed_update | write | |
light_remote_search_cancel | read | |
light_remote_search_results | read | |
light_remote_search_start | write | |
light_remote_session | read | |
light_remote_sessions | read | |
light_remote_set_device_policy | write | |
light_remote_set_node_drain | write | |
light_remote_stat_path | read | |
light_remote_write_text_file | write | |
ping | read | |
system_status | read | |
vps_identity | read | |
workspace_roots | read |
Trust audit
BLOCKgrade F · trust 43/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (17 observation(s))
- Network
- declared (8 observation(s))
- Shell
- declared (10 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
new Function(scripts[0]);
new Function(inlineDownloadScripts[0]);
new Function(scripts[0]);
new Function(publicScripts[0]);
new Function(loginScripts[0]);
const DENY_NAME = /(^\.env($|\.)|secret|token|credential|password|id_ed25519|id_rsa|\.pem$|\.key$|\.p12$|\.pfx$|\.npmrc$|\.netrc$)/i;
Light-Remote-Fleet-Wall-0.9.0-rc.24.tar.gz
Light-Remote-Fleet-Wall-0.9.0-rc.6.main1.tar.gz
Light-Remote-Fleet-Wall-0.9.0-rc.6.tar.gz
console.log(`bootstrap-password-file-created=${bootstrapFile}`);ROOT=os.environ.get('LIGHT_REMOTE_ROOT','/opt/gpt-operator-agent'); NODE=f'{ROOT}/current/runtime/node'; AGENT=f'{ROOT}/current/device-agent/operator-agent.mjs'; WALL='http://127.0.0.1:5491/'; ICON=osif /usr/bin/curl -fsS --max-time 1 'http://127.0.0.1:5491/' >/dev/null 2>&1; then WALL_OK=1; break; fi
if /usr/bin/curl -fsS --max-time 1 'http://127.0.0.1:5491/' >/dev/null 2>&1; then WALL_OK=1; break; fi
const password='selftest-bridge-password';
const authFile=path.join(dir,'wall-auth.json'),password='homelab-wall-password-123';writeLocalWallAuthConfig(authFile,{username:'operator',password});const password='selftest-wall-password-123';
apiKey: 'pdl_sdbx_apikey_test',
apiKey: 'pdl_sdbx_apikey_test',
light_remote_delete_path
.light-remote-lane.json
import {UPDATE_CODES,normalizeUpdateReport,normalizeUpdateStatus} from '../../lib/update-contract.mjs';import { UPDATE_CODES } from '../../lib/update-contract.mjs';function updaterSelfTest(){const source=fileURLToPath(import.meta.url),contract=fileURLToPath(new URL('../../lib/update-contract.mjs',import.meta.url));if(!fs.existsSync(source)||!fs.existsSync(contraimport {UPDATE_CODES,normalizeUpdateReport,normalizeUpdateStatus} from '../../lib/update-contract.mjs';import {UPDATE_CODES} from '../../lib/update-contract.mjs';Gates applied: no_behavioural_pass.
04b6583cb630full audit observations/trust-audit/mcp-server/n8n2erpnext__light-remote-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | 04b6583cb630 | BLOCK | F | 43 | first audit |
Questions
What is the light-remote-mcp MCP server?
Light Remote MCP turns a Windows or Linux machine into an explicitly authorized remote execution target for ChatGPT, Claude, Codex, and other MCP-capable AI workflows.
What tools does light-remote-mcp expose?
44 in total: 33 read-only, 10 that write, and 1 that can delete or overwrite (light_remote_delete_path). Every one is listed on this page with its risk.
Is light-remote-mcp safe to connect to an agent?
No — not without reading the findings first. The audit graded it F (43/100) and found 6 critical or high issues in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does light-remote-mcp need?
It reads CLIENT_UPDATE_SIGNING_KEY_FILE, GPT_OPERATOR_UPDATE_PUBLIC_KEY, LIGHT_REMOTE_GOOGLE_OAUTH_FILE, LIGHT_REMOTE_PLUGIN_OAUTH_LEGACY_CLIENTS_FILE, LIGHT_REMOTE_PLUGIN_OAUTH_SECRET, LIGHT_REMOTE_PLUGIN_OAUTH_SECRET_FILE, OPERATOR_AGENT_WALL_AUTH_FILE, OPERATOR_FLEET_AUTHORITY_CHECK_MS, OPERATOR_FLEET_AUTHORITY_RENEW_SKEW_MS, OPERATOR_FLEET_AUTHORITY_TTL_MS, OPERATOR_KEY_FILE and OPERATOR_PUBLIC_KEYS_FILE from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does light-remote-mcp run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as light-remote-direct-plugin-server at 0.1.5.
How current is this page?
The grade is for one exact copy of the source (04b6583cb630), read on 2026-10-12. The repository is watched and re-audited when it changes.