Skip to main content
Glama
local-computer-full-access-mcp

local-computer-full-access-mcp

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.

CAUTION

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

  1. Extract this folder to a permanent location, for example:

    %USERPROFILE%\Documents\Local-Computer-Full-Access-MCP

  2. Double-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

  1. Double-click START_CHATGPT.bat.

  2. Keep the terminal window open.

  3. Wait until it prints CHATGPT MCP ENDPOINT.

  4. Copy the complete endpoint ending in /mcp/<long-secret>.

  5. In a supported ChatGPT workspace on the web, enable Developer mode and create a custom app/MCP connector.

  6. Paste the endpoint, choose No authentication for this temporary capability-URL setup, scan the tools, and create the app.

  7. 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=stdio

An example generic client config is in mcp-client-config.example.json.

Tools

Read-only tools:

  • pc_status

  • list_drives

  • file_info

  • list_directory

  • read_text_file

  • read_binary_file_base64

  • search_files

  • list_processes

Write/action tools:

  • write_text_file

  • write_binary_file_base64

  • replace_text

  • make_directory

  • copy_path

  • move_path

  • delete_path

  • run_command

  • start_process

  • terminate_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%\Projects

See 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.py

Audit 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 tools
copy_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

    A3.7/5.0

    Scored across 18 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables remote filesystem and CLI access to a Windows machine over LAN through MCP, with file read/write and command execution capabilities.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      3
      GPL 3.0
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      -

    Appeared in Searches