DevBridge MCP
Provides Git inspection and repository workflow capabilities for local projects.
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., "@DevBridge MCP inspect src/App.tsx and fix the broken import"
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.
DevBridge MCP
Created and maintained by GeekMac-dev.
A Windows-based local MCP server for AI-assisted programming. The public edition provides file inspection and editing, controlled terminal and project tasks, Git inspection, browser testing, UI/UX design references, optional coding integrations, activity monitoring, and local Codex CLI history search.
Not included: private data, personal development profiles, SQL analytics, sales reporting, ERPNext-specific WSL automation, mobile gateway, or animation studio features.
Requirements
Windows 10/11 and PowerShell 5.1 or newer
Node.js and npm (install an active supported Node.js LTS release)
Git for Git inspection and repository workflows
Your own source projects, with explicit local file permissions
Optional: Chrome or Playwright Chromium, Semgrep CLI, Context7 API key, local Codex CLI history
For ChatGPT Plugins: a compatible ChatGPT account/workspace with permission to add custom MCP servers, plus a supported Secure MCP Tunnel or a properly protected public HTTPS MCP endpoint. Access to tunnel software and credentials is not included in this repository.
No Docker, MariaDB, SQL Server, or paid integrations are required.
Related MCP server: MCPort
1. Install on your computer
Open PowerShell in the cloned repository:
git clone https://github.com/GeekMac-dev/devbridge_mcp.git
cd devbridge_mcp
npm ci
npm run build
npm run test:integrations
npm run test:design
Copy-Item .env.example .env.localEdit .env.local to match your machine. In particular set BRIDGE_WRITE_ROOTS to the directories you want the bridge to access, such as D:\Projects. Do not set broad drive roots unless you understand the risks. The supplied .env.example deliberately starts optional execution/browser features disabled.
Start the authenticated local HTTP MCP server:
powershell -ExecutionPolicy Bypass -File .\scripts\start-local.ps1This script loads .env.local, builds the project, creates a long random local MCP token if one does not already exist, and starts the server at http://127.0.0.1:8788/mcp (unless you changed the port). The token is stored in %LOCALAPPDATA%\DevBridgeMCP\mcp-token.txt; the value is never printed. Keep that file private.
In another PowerShell terminal, check health:
Invoke-RestMethod http://127.0.0.1:8788/healthA healthy response confirms the HTTP server started. It does not confirm ChatGPT connectivity or permissions.
Important: npm run start:http or npm start alone does not parse .env.local. Use start-local.ps1 for the HTTP setup shown here. npm start starts the stdio MCP server for compatible local MCP clients and is separate from connecting ChatGPT on the web.
2. Connect through ChatGPT Plugins
Follow the detailed Plugins setup guide for account requirements, tunnel configuration, authentication, and plugin creation.
Summary:
Start the bridge locally using
scripts/start-local.ps1.Connect your local MCP endpoint through an authorized Secure MCP Tunnel, or deploy behind your own properly authenticated HTTPS endpoint. Never expose port 8788 directly.
In ChatGPT on the web, open Plugins → + → Add custom MCP server where that option is available to you.
Choose the supported Tunnel connection and provide your tunnel ID, or choose your secured HTTPS MCP URL. Configure authentication according to the endpoint or tunnel.
Review the risk warning, create the plugin, inspect discovered tools, and install/test it in a conversation by mentioning it with
@.
Custom server features, especially write/modify actions, are account/workspace dependent. Some personal plans may have only read/fetch access. Business and Enterprise/Edu workspaces have additional admin and permission requirements. See the official ChatGPT custom MCP connection guide.
3. Enable only the programming tools you need
Capability | Environment setting | Default |
Allowed project directories |
| Example placeholder; edit |
Project build/test tasks |
| Off |
Controlled terminal operations |
| Off |
Controlled PowerShell scripts |
| Off |
Browser testing |
| Off |
Approved browser origins |
| Empty |
Local activity tracking |
| Off |
Semgrep scan |
| Off |
Context7 documentation lookup |
| Off |
Context7 credential |
| Empty |
Optional Codex history location |
| Auto-detected |
If a tool reports that it is disabled, review the relevant setting and restart the bridge. Opt-in settings do not install external tools. Example: enabling Semgrep requires Semgrep to be separately installed. Consult PLAYWRIGHT_SETUP.md for browser-mode configuration.
License, creator credit, and contributions
DevBridge MCP is released under the MIT License.
Copyright © 2026 GeekMac-dev. You may use, modify, and redistribute this project under the MIT terms. Redistributions and substantial copies must retain the copyright and license notice. A link back to the original repository is appreciated, although the MIT License does not require a prominent credit in your app interface.
Contributions are welcome; see CONTRIBUTING.md. Only contribute code you have the rights to license, and preserve existing third-party copyright notices and licenses where applicable.
Community standards
Code of Conduct — respectful, constructive collaboration.
Contributing Guidelines — contribution workflow and checks.
Security Policy — private vulnerability reporting and safe operation.
Issue Templates — bug reports and feature requests.
Pull Request Template — changes, tests, and security checklist.
Accessibility Statement — accessibility goals and reporting.
4. Security and sharing
Never publish .env.local, bearer tokens, tunnel IDs or API keys, logs, browser profiles, indexes, credentials, company source code, or user data. The repository's .gitignore excludes common generated/private paths, but review git status and git diff --cached before every push. Use a fresh Git repository rather than copying history from a private checkout.
Even with this bridge on localhost, tools can edit local files and execute approved tasks as your Windows user. Only install and connect this bridge on computers and projects that you own or are authorized to administer. Read PUBLISHING.md before making a fork public.
Troubleshooting
No
.env.local: copy the supplied example and update the project roots.Unauthorized / 401: check that the tunnel passes your token as an Authorization bearer header.
503 MCP authentication unavailable: check that the token file exists, the bridge account can read it, and
MACBRIDGE_MCP_TOKEN_FILEpoints to it.Plugin cannot connect: ChatGPT cannot use a loopback URL directly; start or configure a supported tunnel or secured public endpoint.
No write tools in ChatGPT: check plan/workspace eligibility and plugin permissions. Some plans support only read/fetch.
No tools / stale tools: reconnect or refresh the plugin tool list where supported.
Missing terminal or browser actions: review the opt-in variables and restart the bridge.
Build fails: run
npm ciand verify your installed Node.js version.
Development commands
npm run build
npm run test:integrations
npm run test:design
npm run scan
npm run activityOfficial documentation: Custom MCP servers in ChatGPT · Plugins in ChatGPT.
Available Tools
40 toolsbrowser_accessibility_basicARead-onlyIdempotent
Read-only heuristic accessibility checks in the current approved browser page; not a complete axe-core audit.
Inputs: no named parameters.
browser_axe_auditARead-onlyIdempotent
Run installed axe-core WCAG audit on the current locally approved browser page (read-only).
Inputs: no named parameters.
browser_clickADestructive
Click an exact locator. Can change ERP data; requires explicit authorization and confirm=true.
Inputs: kind (required), target (required), role, confirm.
browser_closeBIdempotent
Close the dedicated Playwright browser session.
Inputs: no named parameters.
browser_diagnosticsBRead-onlyIdempotent
Inspect recent browser console errors, uncaught exceptions, HTTP errors and failed requests. Optional clear resets diagnostic history.
Inputs: clear.
browser_fillCDestructive
Fill one exact locator. May trigger autosave; requires explicit authorization and confirm=true.
Inputs: kind (required), value (required), target (required), role, +1 more.
browser_openARead-onlyIdempotent
Open an approved HTTP(S) site in the dedicated Chrome profile; otherwise return local PowerShell approval instructions. Never self-approves websites.
Inputs: url (required).
browser_performanceARead-onlyIdempotent
Read-only browser timing and slow resource summary of the current approved page.
Inputs: no named parameters.
browser_screenshotBRead-onlyIdempotent
Capture a viewport screenshot (may contain private ERPNext data).
Inputs: no named parameters.
browser_snapshotARead-onlyIdempotent
Read the current browser page title, URL, and visible text.
Inputs: no named parameters.
browser_source_probeARead-onlyIdempotent
Reload the authenticated development page and inspect only invalid resource references in the original HTML; excludes boot data.
Inputs: no named parameters.
browser_statusBRead-onlyIdempotent
Check the opt-in Playwright browser configuration.
Inputs: no named parameters.
codex_storage_infoCRead-onlyIdempotent
Show detected Codex storage.
Inputs: no named parameters.
context7_docsBRead-onlyIdempotent
Opt-in read-only Context7 documentation lookup using a fixed HTTPS endpoint; never sends project files.
Inputs: query (required), library_id (required).
design_auditCRead-onlyIdempotent
Read-only scan for potential UI consistency issues; does not alter project files.
Inputs: project_path (required).
design_initializeB
Create a project DESIGN.md from an inspiration profile, only if absent. Never overwrites.
Inputs: profile (required), project_path (required).
design_library_catalogCRead-onlyIdempotent
Discover every current upstream Awesome DESIGN.md reference (refresh optional).
Inputs: query, refresh.
design_library_guidanceBRead-onlyIdempotent
Produce a project-aware design implementation plan using the full reference and current project audit. No source edits.
Inputs: id (required), project_path (required).
design_library_importAIdempotent
Save an upstream design reference in .design-references without overwriting the approved DESIGN.md.
Inputs: id (required), project_path (required).
design_library_readBRead-onlyIdempotent
Read a full version-pinned upstream DESIGN.md by catalog ID.
Inputs: id (required), refresh.
design_profilesBRead-onlyIdempotent
Browse original design-inspiration profiles based on awesome-design-md.
Inputs: no named parameters.
design_readBRead-onlyIdempotent
Read a project's DESIGN.md without modifying it.
Inputs: project_path (required).
file_infoCRead-onlyIdempotent
Read metadata for an absolute local path.
Inputs: path (required).
get_codex_sessionBRead-onlyIdempotent
Return messages from one Codex session.
Inputs: session_id (required), limit.
git_inspectBRead-onlyIdempotent
Read local repository status and diff statistics (never stages or commits).
Inputs: project_path (required).
integration_catalogARead-onlyIdempotent
List available and pending development-tool integrations.
Inputs: no named parameters.
latest_codex_sessionsCRead-onlyIdempotent
Return recent Codex sessions.
Inputs: limit.
list_directoryBRead-onlyIdempotent
List entries in an absolute local directory.
Inputs: path (required), limit.
list_drivesBRead-onlyIdempotent
List readable local Windows drives.
Inputs: no named parameters.
patch_fileBDestructive
Replace exact text inside a UTF-8 file in an allowlisted development folder.
Inputs: path (required), search (required), replace (required), replace_all.
project_task_planBRead-onlyIdempotent
Inspect a defined npm build/test/lint task without executing it.
Inputs: task (required), project_path (required).
project_task_runA
Run a predefined npm build/test/lint task in an approved local project and return the exit code and logs. Requires BRIDGE_PROJECT_COMMANDS_ENABLED=1.
Inputs: task (required), project_path (required).
read_fileCRead-onlyIdempotent
Read a local text file by absolute path.
Inputs: path (required), max_chars.
scan_codex_historyAIdempotent
Scan local Codex session files into the local search index.
Inputs: no named parameters.
search_codex_historyCRead-onlyIdempotent
Search indexed Codex conversations.
Inputs: query (required), limit.
search_filesARead-onlyIdempotent
Search text recursively from an absolute local directory.
Inputs: root (required), query (required), limit.
semgrep_scanBRead-onlyIdempotent
Opt-in Semgrep static security scan; requires local Semgrep CLI and BRIDGE_SEMGREP_ENABLED=1.
Inputs: project_path (required).
terminal_planBRead-onlyIdempotent
Plan a supported development command without executing it.
Inputs: action (required), project_path (required), script.
terminal_runCDestructive
Execute a controlled project command. PowerShell scripts need separate local opt-in and explicit confirmation.
Inputs: action (required), project_path (required), script, confirm.
write_fileBDestructive
Create or replace a UTF-8 text file inside an allowlisted development folder.
Inputs: path (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Tools are grouped into clear sub-domains (Codex history, filesystem, browser, terminal/tasks, design, integrations) and names mostly specify both resource and action, so most selections are unambiguous. A few boundaries blur: design_profiles vs design_library_catalog and browser_snapshot vs browser_source_probe vs browser_diagnostics require reading descriptions to differentiate, and design_library_guidance overlaps conceptually with design_audit.
Dominant convention is snake_case verb_noun (read_file, patch_file, search_files, browser_click, design_initialize), with consistent prefixes per sub-domain (browser_, design_, design_library_, terminal_, project_task_). Minor deviations are noun-first names such as file_info, browser_status, codex_storage_info, and integration_catalog, which break the pattern without harming readability.
40 tools is heavy for a single server, and the surface spans at least eight loosely related domains (history indexing, filesystem, Playwright automation, command execution, design references, static analysis, docs). While each tool is non-redundant, the volume forces agents to sift a large catalog and suggests the server should be split by concern.
Each sub-domain has near-full lifecycle coverage: plan/run pairs for terminal and project tasks, scan/search/get/list for Codex history, and open/snapshot/click/fill/diagnostics/close for the browser, plus a coherent design-reference workflow (catalog, read, import, initialize, audit, guidance). Gaps exist—no delete/rename/move for files, no mkdir, and git is inspect-only—but these appear deliberate (allowlist safety) and are workable around.
Maintenance
Related MCP Connectors
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Project memory, documentation and controlled secret access for AI coding agents.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to securely inspect local Codex projects, read session history, and dispatch confirmed tasks to the Codex CLI through a local MCP bridge.1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to safely read, search, understand, and edit local project code and files, with Git inspection, code indexing, and controlled command execution within permissioned workspaces.8 npm6MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to securely inspect, modify, and manage local projects with trusted filesystem access, safe Git operations, controlled task execution, and developer runtime process management over stdio or HTTP.4Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables ChatGPT to inspect and edit local projects, run bounded commands, use Git, automate Chrome or Edge, and control connected Excel workbooks, while invoking the Codex model only when explicitly needed.-