Local Coding Agent

A local MCP server that lets ChatGPT Web (or any MCP client) act as a coding
agent on your own machine — read/write files, run commands, manage
background processes, and use git — confined to folders you choose. Ships with a
Windows tray app to manage it and a local metrics dashboard.

⚠️ This tool can run commands on your computer. Read SECURITY.md
before using it. It is not a sandbox; only connect workspaces you trust.

🇬🇧 English · 🇻🇳 Tiếng Việt

English

Features

• 20+ coding tools over MCP: repo_overview, list_files, find_files,
  read_file, read_many (batch read), search_text (ripgrep/git, with
  context + glob), write_file, replace_in_file, apply_patch (multi-file),
  make_dir, move_path, delete_path, run_command (cmd/powershell/bash),
  background processes (proc_start/list/output/stop), git, and notes.
• Speed-tuned: compact JSON, relative paths, batch reads, one-call repo map —
  fewer round-trips over the tunnel.
• Safety layers: loopback-only bind, root confinement, safe/full modes,
  catastrophic-command blocklist, optional bearer token, audit log.
• Windows tray app (C#/.NET): start/stop, status, copy MCP URL, encrypted
  key storage (DPAPI), authoritative Stop.
• Local dashboard (/ui): tool-call metrics, estimated token throughput, a
  per-minute chart, top tools, and recent calls with error reasons.

Architecture

ChatGPT Web
   │  (HTTPS via the OpenAI Secure MCP Tunnel — private to your account)
   ▼
tunnel-client.exe  ──►  Node MCP server (127.0.0.1:8787)  ──►  your files/commands
                              │
                              └─► local dashboard (127.0.0.1:8790/ui, not tunneled)

Windows tray app supervises the node server + tunnel-client.

Repository layout

server/      Node MCP server (server.mjs) + tests
tray-app/    C#/.NET WinForms tray app (source)
scripts/     start-tunnel.ps1 launcher
tools/        (you create) place your tunnel-client.exe here — gitignored

Prerequisites

• Node.js 18+ (for the server).
• .NET 8+ SDK (only if you build the tray app).
• A ChatGPT account with MCP connector / Apps access.
• The OpenAI Secure MCP Tunnel client (tunnel-client.exe). It is not
  included in this repo (proprietary). Obtain it from OpenAI and place it at
  tools/tunnel-client.exe.

Quick start

1) Run the MCP server

cd server
npm install
#   PowerShell:  $env:AGENT_WORKSPACE="C:\path\to\your\repo"
#   bash:        export AGENT_WORKSPACE="/path/to/your/repo"
npm start

Check it: open http://127.0.0.1:8787/healthz and the dashboard
http://127.0.0.1:8790/ui.

2) Expose it to ChatGPT via the secure tunnel

Put your tunnel-client.exe in tools/, then:

# edit the variables at the top of the script first (workspace, tunnel path)
powershell -ExecutionPolicy Bypass -File scripts\start-tunnel.ps1

Paste your tunnel Runtime API key when prompted, then add the resulting MCP URL
as a connector in ChatGPT.

3) (Optional) Use the tray app instead of scripts

cd tray-app
dotnet run
# or build a single self-contained exe:
powershell -ExecutionPolicy Bypass -File build.ps1

Configuration

Security

See SECURITY.md. In short: it is not a sandbox, prompt
injection is real, keep safe mode unless you know what you're doing, and never
expose it on a public tunnel without MCP_AUTH_TOKEN.

License

AGPL-3.0-or-later © 2026 Long Nguyễn (@LongNgn204).

Free and open source. You may use, study, modify, and share it — but if you
distribute it or run a modified version as a network service, you must release
your source under the same AGPL-3.0 license and keep the copyright notice. This
keeps the project free for everyone and prevents closed, proprietary forks.

This project is not affiliated with or endorsed by OpenAI. "ChatGPT" and
related marks belong to their owners. You must obtain the tunnel client and
use ChatGPT in accordance with OpenAI's terms.

Tiếng Việt

Một MCP server cục bộ giúp ChatGPT Web (hoặc bất kỳ MCP client nào) hoạt động
như một coding agent trên chính máy của bạn — đọc/ghi file, chạy lệnh, quản lý
tiến trình nền, dùng git — giới hạn trong các thư mục bạn chọn. Kèm app tray
Windows để quản lý và một dashboard số liệu cục bộ.

⚠️ Công cụ này có thể chạy lệnh trên máy bạn. Hãy đọc SECURITY.md
trước khi dùng. Đây không phải sandbox; chỉ kết nối workspace bạn tin tưởng.

Tính năng

• Hơn 20 tool coding qua MCP: repo_overview, list_files, find_files,
  read_file, read_many (đọc nhiều file 1 lần), search_text (ripgrep/git,
  kèm context + glob), write_file, replace_in_file, apply_patch (sửa nhiều
  file), make_dir, move_path, delete_path, run_command
  (cmd/powershell/bash), tiến trình nền (proc_start/list/output/stop), git,
  và ghi chú.
• Tối ưu tốc độ: JSON gọn, đường dẫn tương đối, đọc theo lô, map repo trong 1
  lần gọi — giảm round-trip qua tunnel.
• Nhiều lớp an toàn: chỉ bind loopback, giới hạn thư mục gốc, chế độ
  safe/full, blocklist lệnh thảm hoạ, token tuỳ chọn, audit log.
• App tray Windows (C#/.NET): start/stop, trạng thái, copy MCP URL, lưu key
  mã hoá (DPAPI), nút Stop dừng được cả tiến trình ngoài app.
• Dashboard cục bộ (/ui): số liệu tool, ước tính token, biểu đồ theo phút,
  top tool, và các lệnh gần đây kèm lý do lỗi.

Kiến trúc

ChatGPT Web
   │  (HTTPS qua OpenAI Secure MCP Tunnel — riêng cho tài khoản của bạn)
   ▼
tunnel-client.exe  ──►  Node MCP server (127.0.0.1:8787)  ──►  file/lệnh của bạn
                              │
                              └─► dashboard cục bộ (127.0.0.1:8790/ui, KHÔNG qua tunnel)

App tray Windows giám sát node server + tunnel-client.

Cấu trúc repo

server/      Node MCP server (server.mjs) + test
tray-app/    App tray C#/.NET WinForms (source)
scripts/     Launcher start-tunnel.ps1
tools/        (bạn tự tạo) đặt tunnel-client.exe ở đây — đã gitignore

Yêu cầu

• Node.js 18+ (cho server).
• .NET 8+ SDK (chỉ khi build app tray).
• Tài khoản ChatGPT có quyền dùng MCP connector / Apps.
• OpenAI Secure MCP Tunnel client (tunnel-client.exe). Không kèm trong
  repo (độc quyền). Hãy tự lấy từ OpenAI và đặt vào tools/tunnel-client.exe.

Bắt đầu nhanh

1) Chạy MCP server

cd server
npm install
#   PowerShell:  $env:AGENT_WORKSPACE="C:\duong-dan\toi\repo"
#   bash:        export AGENT_WORKSPACE="/duong/dan/toi/repo"
npm start

Kiểm tra: mở http://127.0.0.1:8787/healthz và dashboard
http://127.0.0.1:8790/ui.

2) Đưa ra ChatGPT qua secure tunnel

Đặt tunnel-client.exe vào tools/, rồi:

# sửa các biến ở đầu script trước (workspace, đường dẫn tunnel)
powershell -ExecutionPolicy Bypass -File scripts\start-tunnel.ps1

Dán Runtime API key của tunnel khi được hỏi, rồi thêm MCP URL thu được làm
connector trong ChatGPT.

3) (Tuỳ chọn) Dùng app tray thay cho script

cd tray-app
dotnet run
# hoặc build 1 file exe self-contained:
powershell -ExecutionPolicy Bypass -File build.ps1

Cấu hình

Bảo mật

Xem SECURITY.md. Tóm tắt: đây không phải sandbox, prompt
injection là rủi ro thật, hãy giữ safe mode trừ khi bạn hiểu rõ, và đừng bao
giờ expose qua tunnel public mà không đặt MCP_AUTH_TOKEN.

Giấy phép

AGPL-3.0-or-later © 2026 Long Nguyễn (@LongNgn204).

Miễn phí và mã nguồn mở. Bạn được dùng, học hỏi, sửa đổi và chia sẻ — nhưng nếu
phân phối lại hoặc chạy bản đã sửa dưới dạng dịch vụ mạng, bạn phải công khai
mã nguồn theo cùng giấy phép AGPL-3.0 và giữ nguyên dòng bản quyền. Điều này
giữ cho dự án luôn miễn phí với mọi người và ngăn việc đem đóng kín/thương mại
hoá riêng.

Dự án không liên kết hay được bảo trợ bởi OpenAI. "ChatGPT" và các nhãn liên
quan thuộc về chủ sở hữu của chúng. Bạn phải tự lấy tunnel client và dùng
ChatGPT theo đúng điều khoản của OpenAI.