local-computer-full-access-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@local-computer-full-access-mcp list my drives and show free space"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Local Computer Full-Access MCP
A Windows-first MCP server that gives an MCP client Codex-like local capabilities through explicit tools:
unrestricted PowerShell, Command Prompt, or Bash commands;
read, create, edit, copy, move, search, and delete files/directories;
list drives and inspect disk capacity;
start, inspect, and terminate processes;
local JSONL audit logging;
stdio transport for local MCP hosts;
Streamable HTTP plus an HTTPS tunnel for ChatGPT;
DNS-rebinding protection with tunnel Host-header rewriting;
one-click shutdown via
STOP_MCP.bat.
run_command makes this genuinely full access under the Windows account running the server. It is not a simulated filesystem.
This project can execute arbitrary commands, modify or delete files, start processes, and expose everything accessible to the Windows account running it. Use it only on a computer you control. Keep the server bound to127.0.0.1, never publish the complete MCP endpoint URL, and stop the server when it is not in use. Read SECURITY.md before enabling full access.
ChatGPT connectivity and availability
ChatGPT cannot connect directly to 127.0.0.1 on your PC. This package keeps the MCP service on localhost and uses cloudflared to create an outbound HTTPS tunnel for testing.
Availability of custom MCP apps and write/modify actions depends on the ChatGPT plan and workspace configuration and may change over time. Check OpenAI's current developer mode and MCP apps documentation. The server also works with compatible local MCP hosts over stdio.
Related MCP server: Sky Windows Remote Executor
Install on Windows
Extract this folder to a permanent location, for example:
%USERPROFILE%\Documents\Local-Computer-Full-Access-MCPDouble-click:
INSTALL_WINDOWS.bat
The installer creates a Python virtual environment, installs the official MCP Python SDK, installs cloudflared through winget when needed, creates .env, enables full access because that is the requested mode, generates a random secret endpoint, and runs tests.
Start for ChatGPT
Double-click
START_CHATGPT.bat.Keep the terminal window open.
Wait until it prints
CHATGPT MCP ENDPOINT.Copy the complete endpoint ending in
/mcp/<long-secret>.In a supported ChatGPT workspace on the web, enable Developer mode and create a custom app/MCP connector.
Paste the endpoint, choose No authentication for this temporary capability-URL setup, scan the tools, and create the app.
Enable the app in the chat. Leave confirmations enabled for risky actions.
To stop everything, close the launcher window normally or run STOP_MCP.bat.
The TryCloudflare hostname changes whenever the script restarts, so update the custom app endpoint after each restart. TryCloudflare is for testing, not a permanent deployment. If cloudflared reports that a Quick Tunnel cannot start because you already have %USERPROFILE%\.cloudflared\config.yml or config.yaml, temporarily rename that file or use a separately configured stable Cloudflare Tunnel.
Start over stdio
Double-click START_STDIO.bat, or point a local MCP client at:
command: <folder>\.venv\Scripts\python.exe
args: -m pc_mcp.server
environment: PC_MCP_TRANSPORT=stdioAn example generic client config is in mcp-client-config.example.json.
Tools
Read-only tools:
pc_statuslist_drivesfile_infolist_directoryread_text_fileread_binary_file_base64search_fileslist_processes
Write/action tools:
write_text_filewrite_binary_file_base64replace_textmake_directorycopy_pathmove_pathdelete_pathrun_commandstart_processterminate_process
Example prompts after connection
"Use my local-computer app to list my drives and show free space."
"Inspect the selected project folder, run its tests, fix failures, and show me the changed files."
"Search the selected project folder for references to a specified phrase without changing anything."
"Create a backup of this folder before editing it. Ask before deleting anything."
Configuration
The installer creates .env. Important settings:
PC_MCP_FULL_ACCESS=1
PC_MCP_TRANSPORT=streamable-http
PC_MCP_HOST=127.0.0.1
PC_MCP_PORT=8765
PC_MCP_ENDPOINT_SECRET=<random-secret>To restrict filesystem tools:
PC_MCP_FULL_ACCESS=0
PC_MCP_ALLOWED_ROOTS=%USERPROFILE%\Documents;%USERPROFILE%\ProjectsSee SECURITY.md before leaving this server running or converting the test tunnel into a permanent endpoint.
Test manually
Run RUN_TESTS.bat.
For MCP protocol inspection, activate the virtual environment and run:
.\.venv\Scripts\Activate.ps1
mcp dev server.pyAudit log
Tool actions and command outcomes that reach the core implementation are recorded locally at:
.data\audit.jsonl
File contents, binary payloads, and environment dictionaries are redacted and hashed in the audit record.
Available Tools
18 toolscopy_pathA
Copy a file or directory. This modifies the computer. Existing destinations require overwrite=true.
Inputs: source (required), destination (required), overwrite. Returns: object
delete_pathA
Delete a file, empty directory, or—when recursive=true—a directory tree. DESTRUCTIVE and irreversible outside backups.
Inputs: path (required), recursive, missing_ok. Returns: object
file_infoB
Return metadata for one file, directory, or symbolic link. Read-only.
Inputs: path (required). Returns: object
list_directoryA
List a directory. Set recursive=true only when needed; max_entries prevents huge responses. Read-only.
Inputs: path (required), recursive, max_entries. Returns: object
list_drivesA
List mounted disks/drives and their capacity. Read-only.
Inputs: no named parameters. Returns: result
list_processesA
List running processes, optionally filtered by name or command line. Read-only.
Inputs: max_results, name_filter. Returns: object
make_directoryC
Create a directory. This modifies the computer.
Inputs: path (required), parents, exist_ok. Returns: object
move_pathA
Move or rename a file or directory. This modifies the computer. Existing destinations require overwrite=true.
Inputs: source (required), destination (required), overwrite. Returns: object
pc_statusA
Inspect this MCP server, computer identity, access mode, roots, endpoint, and audit-log location. Read-only.
Inputs: no named parameters. Returns: object
read_binary_file_base64A
Read a small binary file and return base64. Read-only; intended for files that cannot be handled as text.
Inputs: path (required), max_bytes. Returns: object
read_text_fileA
Read a text file with line-window controls. Read-only.
Inputs: path (required), encoding, max_lines, start_line. Returns: object
replace_textA
Make an exact text replacement in a file. This modifies the computer and refuses ambiguous multiple matches unless replace_all=true.
Inputs: path (required), new_text (required), old_text (required), encoding, +1 more. Returns: object
run_commandA
Run an arbitrary PowerShell/cmd/bash command and wait for completion. FULL-ACCESS tool: commands run with the Windows account permissions of this server. Use shell=auto normally.
Inputs: command (required), cwd, shell, environment, +1 more. Returns: object
search_filesA
Search filenames and optionally UTF-8-compatible text contents below a root directory. Read-only.
Inputs: root (required), query (required), glob, max_results, +3 more. Returns: object
start_processB
Start a long-running command in the background and return its PID and log path. FULL-ACCESS tool.
Inputs: command (required), cwd, shell, environment. Returns: object
terminate_processA
Terminate or force-kill a process and optionally its descendants. DESTRUCTIVE; may cause data loss.
Inputs: pid (required), force, include_children. Returns: object
write_binary_file_base64A
Create or overwrite a binary file from base64. This modifies the computer. Existing files require overwrite=true.
Inputs: path (required), data_base64 (required), overwrite, create_parents. Returns: object
write_text_fileA
Create or overwrite a text file. This modifies the computer. Existing files require overwrite=true.
Inputs: path (required), content (required), encoding, overwrite, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool targets a distinct operation: file/directory manipulation, process control, system status, and command execution. Binary and text variants are clearly differentiated, and there is no overlap between list, read, write, replace, copy, move, and delete functions.
Most tools follow a consistent verb_noun pattern (list_directory, read_text_file, copy_path, terminate_process). A couple of tools like pc_status and file_info use noun-based names, but they are still clear and the overall convention remains recognizable and predictable.
With 18 tools, the set is well-scoped for a full-access local computer server. It covers file operations, process management, and system inspection without being bloated or sparse, and each tool serves a necessary role.
The tool surface provides broad lifecycle coverage for files and processes, including read, write, replace, copy, move, delete, and search. The run_command tool acts as a fallback for arbitrary system actions, though a few conveniences like environment variable or service management are missing.
Related MCP Connectors
Control your authorized Windows computers via OAuth: files, shell, apps, and task status.
Use a person's computer after they approve it there: files, Terminal, browser, local MCP.
Use a person's computer after they approve it there: files, Terminal, browser, local MCP.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables remote filesystem and CLI access to a Windows machine over LAN through MCP, with file read/write and command execution capabilities.MIT
- AlicenseNot gradedqualityDmaintenanceEnables remote execution of commands, file operations, screenshots, and clipboard access on Windows machines through MCP tools.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables remote control of a Windows desktop via MCP, including screenshots, mouse and keyboard, window management, PowerShell, files, services, registry, scheduled tasks, event log, and network checks.25 npm3GPL 3.0
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to control and interact with a local Windows computer through authenticated MCP tools, including file operations, shell commands, process management, HTTP requests, and system/media inspection.-