Skip to main content
Glama

DevBridge MCP

Created and maintained by GeekMac-dev.

License: MIT

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.local

Edit .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.ps1

This 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/health

A 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:

  1. Start the bridge locally using scripts/start-local.ps1.

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

  3. In ChatGPT on the web, open Plugins → + → Add custom MCP server where that option is available to you.

  4. 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.

  5. 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

BRIDGE_WRITE_ROOTS

Example placeholder; edit

Project build/test tasks

BRIDGE_PROJECT_COMMANDS_ENABLED=1

Off

Controlled terminal operations

BRIDGE_TERMINAL_ENABLED=1

Off

Controlled PowerShell scripts

BRIDGE_TERMINAL_SCRIPTS_ENABLED=1

Off

Browser testing

BRIDGE_BROWSER_ENABLED=1

Off

Approved browser origins

BRIDGE_BROWSER_ALLOWED_ORIGINS

Empty

Local activity tracking

BRIDGE_ACTIVITY_ENABLED=1

Off

Semgrep scan

BRIDGE_SEMGREP_ENABLED=1

Off

Context7 documentation lookup

BRIDGE_CONTEXT7_ENABLED=1

Off

Context7 credential

CONTEXT7_API_KEY

Empty

Optional Codex history location

CODEX_HOME

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

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_FILE points 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 ci and verify your installed Node.js version.

Development commands

npm run build
npm run test:integrations
npm run test:design
npm run scan
npm run activity

Official documentation: Custom MCP servers in ChatGPT · Plugins in ChatGPT.

Available Tools

40 tools
browser_accessibility_basicA
Read-onlyIdempotent

Read-only heuristic accessibility checks in the current approved browser page; not a complete axe-core audit.

Inputs: no named parameters.

browser_axe_auditA
Read-onlyIdempotent

Run installed axe-core WCAG audit on the current locally approved browser page (read-only).

Inputs: no named parameters.

browser_clickA
Destructive

Click an exact locator. Can change ERP data; requires explicit authorization and confirm=true.

Inputs: kind (required), target (required), role, confirm.

browser_closeB
Idempotent

Close the dedicated Playwright browser session.

Inputs: no named parameters.

browser_diagnosticsB
Read-onlyIdempotent

Inspect recent browser console errors, uncaught exceptions, HTTP errors and failed requests. Optional clear resets diagnostic history.

Inputs: clear.

browser_fillC
Destructive

Fill one exact locator. May trigger autosave; requires explicit authorization and confirm=true.

Inputs: kind (required), value (required), target (required), role, +1 more.

browser_openA
Read-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_performanceA
Read-onlyIdempotent

Read-only browser timing and slow resource summary of the current approved page.

Inputs: no named parameters.

browser_screenshotB
Read-onlyIdempotent

Capture a viewport screenshot (may contain private ERPNext data).

Inputs: no named parameters.

browser_snapshotA
Read-onlyIdempotent

Read the current browser page title, URL, and visible text.

Inputs: no named parameters.

browser_source_probeA
Read-onlyIdempotent

Reload the authenticated development page and inspect only invalid resource references in the original HTML; excludes boot data.

Inputs: no named parameters.

browser_statusB
Read-onlyIdempotent

Check the opt-in Playwright browser configuration.

Inputs: no named parameters.

codex_storage_infoC
Read-onlyIdempotent

Show detected Codex storage.

Inputs: no named parameters.

context7_docsB
Read-onlyIdempotent

Opt-in read-only Context7 documentation lookup using a fixed HTTPS endpoint; never sends project files.

Inputs: query (required), library_id (required).

design_auditC
Read-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_catalogC
Read-onlyIdempotent

Discover every current upstream Awesome DESIGN.md reference (refresh optional).

Inputs: query, refresh.

design_library_guidanceB
Read-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_importA
Idempotent

Save an upstream design reference in .design-references without overwriting the approved DESIGN.md.

Inputs: id (required), project_path (required).

design_library_readB
Read-onlyIdempotent

Read a full version-pinned upstream DESIGN.md by catalog ID.

Inputs: id (required), refresh.

design_profilesB
Read-onlyIdempotent

Browse original design-inspiration profiles based on awesome-design-md.

Inputs: no named parameters.

design_readB
Read-onlyIdempotent

Read a project's DESIGN.md without modifying it.

Inputs: project_path (required).

file_infoC
Read-onlyIdempotent

Read metadata for an absolute local path.

Inputs: path (required).

get_codex_sessionB
Read-onlyIdempotent

Return messages from one Codex session.

Inputs: session_id (required), limit.

git_inspectB
Read-onlyIdempotent

Read local repository status and diff statistics (never stages or commits).

Inputs: project_path (required).

integration_catalogA
Read-onlyIdempotent

List available and pending development-tool integrations.

Inputs: no named parameters.

latest_codex_sessionsC
Read-onlyIdempotent

Return recent Codex sessions.

Inputs: limit.

list_directoryB
Read-onlyIdempotent

List entries in an absolute local directory.

Inputs: path (required), limit.

list_drivesB
Read-onlyIdempotent

List readable local Windows drives.

Inputs: no named parameters.

patch_fileB
Destructive

Replace exact text inside a UTF-8 file in an allowlisted development folder.

Inputs: path (required), search (required), replace (required), replace_all.

project_task_planB
Read-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_fileC
Read-onlyIdempotent

Read a local text file by absolute path.

Inputs: path (required), max_chars.

scan_codex_historyA
Idempotent

Scan local Codex session files into the local search index.

Inputs: no named parameters.

search_codex_historyC
Read-onlyIdempotent

Search indexed Codex conversations.

Inputs: query (required), limit.

search_filesA
Read-onlyIdempotent

Search text recursively from an absolute local directory.

Inputs: root (required), query (required), limit.

semgrep_scanB
Read-onlyIdempotent

Opt-in Semgrep static security scan; requires local Semgrep CLI and BRIDGE_SEMGREP_ENABLED=1.

Inputs: project_path (required).

terminal_planB
Read-onlyIdempotent

Plan a supported development command without executing it.

Inputs: action (required), project_path (required), script.

terminal_runC
Destructive

Execute a controlled project command. PowerShell scripts need separate local opt-in and explicit confirmation.

Inputs: action (required), project_path (required), script, confirm.

write_fileB
Destructive

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

    B3.1/5.0

    Scored across 40 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      4
      Apache 2.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -