AI 클라이언트에서 파일 시스템 편집, 터미널 액세스, Git 워크플로우 및 시맨틱 브라우저 테스트를 수행할 수 있는 권한 제어형 로컬 에이전트를 제공합니다.
다른 이름 t1ktakdev/ForgeBridge
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.0-alpha.4
- 마지막 커밋
- 2026년 9월 21일
- 라이선스
- Apache-2.0
ForgeBridge MCP란?
AI 클라이언트에서 파일 시스템 편집, 터미널 액세스, Git 워크플로우 및 시맨틱 브라우저 테스트를 수행할 수 있는 권한 제어형 로컬 에이전트를 제공합니다.
프로젝트 README에서 생성된 요약
ForgeBridge MCP server 정보
ForgeBridge는 AI 클라이언트에 워크스테이션에 대한 제어된 액세스 권한을 부여하려는 개발자를 위해 설계된 권한 제어형 로컬 에이전트입니다. 파일 시스템 편집, 터미널 상호작용, Git 워크플로우 및 시맨틱 브라우저 테스트를 용이하게 합니다. 이 서버는 로컬에서 작동하며 stdio를 통해 AI 클라이언트에 연결하거나, ChatGPT와 같은 웹 기반 인터페이스를 위해 OpenAI Secure MCP Tunnel을 사용하여 아웃바운드 HTTPS 경로로 연결할 수 있습니다.
사용자는 로컬 Control Center를 통해 에이전트를 관리하며 권한 검토, 활성 작업 모니터링, 감사 로그 확인을 수행할 수 있습니다. 시스템은 deny-first 권한 엔진을 사용하여 모든 동작이 승인된 canonical root 내에서만 이루어지도록 보장합니다. 개발자는 project_inspect 도구를 사용하여 프로젝트 스택, 호스트 운영 체제 및 Git 상태를 빠르게 파악할 수 있습니다. 높은 수준의 자동화를 제공하면서도, 쓰기 작업에 대한 승인을 요구하고 브라우저 세션을 기본적으로 격리하여 보안을 유지합니다.
활용 사례
- 1자동화된 프로젝트 환경 탐색AI 클라이언트가 단일 명령으로 현재 프로젝트 스택, 셸 및 Git 상태를 식별할 수 있습니다.
- 2제어된 파일 시스템 및 Git 관리개발자는 AI가 특정 프로젝트 경계 내에서 일상적인 코딩 작업과 Git 작업을 수행하도록 허용할 수 있습니다.
- 3감독 가능한 터미널 실행사용자는 전용 인터페이스를 통해 대화형 터미널 세션과 장시간 실행되는 작업을 모니터링하고 승인할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ForgeBridge MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 ForgeBridge MCP 설치
$ claude mcp add forgebridge -- npx -y forgebridgeCursor에 ForgeBridge MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"forgebridge": {
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}VS Code에 ForgeBridge MCP 설치
.vscode/mcp.json
{
"servers": {
"forgebridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}VS Code CLI에 ForgeBridge MCP 설치
$ code --add-mcp '{"name":"forgebridge","type":"stdio","command":"npx","args":["-y","forgebridge"]}'Claude Desktop에 ForgeBridge MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"forgebridge": {
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}Codex에 ForgeBridge MCP 설치
$ codex mcp add forgebridge -- npx -y forgebridgeCodex config.toml에 ForgeBridge MCP 설치
~/.codex/config.toml
[mcp_servers.forgebridge] command = "npx" args = ["-y", "forgebridge"]
Gemini CLI에 ForgeBridge MCP 설치
$ gemini mcp add -s user forgebridge npx -- -y forgebridgeGemini settings.json에 ForgeBridge MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"forgebridge": {
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능t1ktakdev/forgebridge is public and reachablegithub.com/t1ktakdev/forgebridge ↗통과
- 패키지가 이 저장소를 소스로 명시forgebridge names t1ktakdev/forgebridge as sourcenpmjs.com/package/forgebridge ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-21github.com/t1ktakdev/forgebridge ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from forgebridge통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음106 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기ForgeBridge
Status: public alpha / beta testing. ForgeBridge is available for early real-world testing, but it is not a stable production release yet. Commands, MCP schemas, configuration, and behavior may change between alpha/beta versions. The project will continue to receive updates, fixes, UX improvements, and new capabilities.
ForgeBridge is a local, permissioned MCP agent for development work on a computer the user owns and
explicitly authorizes. It is designed for filesystem editing, interactive terminals, durable jobs,
Git workflows, and semantic browser testing from compatible AI clients. For model-driven
development, ForgeBridge exposes semantic project inspection, Git reads, and reviewed validation
operations so routine work does not require arbitrary shell commands. Start with project_inspect
to learn the project stack, Git state, host OS, and shell in one bounded call. See
the model-first workflow.
This repository is under active development toward v0.1 and should be treated as test/beta software. Current status and verified limitations are tracked in the implementation plan. Issues and feedback are welcome; future releases will continue improving stability, onboarding, remote/multi-device UX, and tool coverage.
Control Center
ForgeBridge includes a local Control Center for understanding what the agent is doing, reviewing permissions, following jobs and sessions, and inspecting the audit trail without digging through raw state files.
| Projects | Approvals |
|---|---|
The interface supports English and Russian, dark and light themes, responsive layouts, live jobs, sessions, approvals, project policies, and a redacted audit feed backed by the real local Control API.
Project status
Current public release: v0.1.0-alpha.4 · Channel: next · Estimated v1.0 readiness:
≈68%
The percentage is a weighted milestone estimate, not a quality score or release date. It is updated as major product blocks move from experimental to release-ready.
| Area | Status |
|---|---|
| Local agent, permissions, audit, filesystem, Git, terminal, durable jobs, browser | ✅ Shipped |
| Control Center, RU/EN, themes, lifecycle actions, guided setup | ✅ Shipped |
| Cross-platform CI, npm package, MCP Registry, SBOM/checksums | ✅ Shipped |
| Update / repair / recovery | 🟡 In progress |
| Public API stability, migrations, deprecation policy | 🟡 In progress |
| Multi-device / remote routing | 🟠 Next major product block |
| Compatibility matrix + independent security pass | 🟠 Required before 1.0 |
Next milestone: 0.2.0-beta.1 — multi-device foundation, lifecycle/update UX, and the first
compatibility freeze.
See the full Road to 1.0.
Quick start
The public alpha package name is forgebridge; the installed command stays forgebridge. Once the
first npm release is live:
npm install --global forgebridge@next
forgebridge init --root /path/to/your/project
forgebridge doctor
forgebridge browser install
forgebridge serve --transport stdio
MCP clients that launch stdio servers can run ForgeBridge without a global install:
npx -y forgebridge@next serve --transport stdio
ForgeBridge is also prepared for discovery through the official MCP Registry as
io.github.t1ktakdev/forgebridge. Browser automation needs a reviewed Chromium/Chrome/Edge
installation; Windows UI Automation remains opt-in. See
installation and packaging for platform-specific setup.
Design
ForgeBridge keeps privileged enforcement on the workstation:
- every action is checked by a deny-first permission engine;
- paths are restricted to canonical allowed roots;
- write approvals are bound to the exact action and expire;
- terminal and job output is bounded and paginated;
- browser sessions are isolated by default;
- the default BACKGROUND execution profile forces headless browsers and defers focus-changing desktop actions;
- attempted and completed actions are written to a redacted, hash-chained audit log.
For ChatGPT web, the preferred v0.1 transport is OpenAI Secure MCP Tunnel, which creates an outbound HTTPS path without publishing a port on the workstation. Local MCP clients can use stdio directly.
See:
- Model-first development workflow
- Research
- Architecture
- Security model
- Security validation matrix
- Windows validation record
- 2026-09-15 model-UX hardening validation
- Release-readiness audit
- Permission model
- Threat model
- Secure tunnel runbook
- Windows autostart
- Background execution and focus protection
- Implementation plan
Development
Requirements: Node.js 22 or newer, pnpm 11, Git, and Windows 10/11 for native validation.
pnpm install
pnpm check
pnpm build
node dist/cli.js init --root C:\src\my-project
node dist/cli.js serve --transport stdio
Trusted local development
For a repository you explicitly trust, ForgeBridge can remove repeat approval prompts for reviewed repository-defined validation while keeping the same canonical root boundary and hard-deny rules:
forgebridge project trust C:\src\my-project
This creates a per-project FULL profile with autonomy: trusted-local. It is intentionally local
configuration: repository files cannot enable it. Reviewed project_check plans can then run
without a fresh approval, while destructive commands, Git push, elevation, persistence, secret
access, consequential browser/Windows submissions, and anything outside the configured root remain
gated or denied. Revert with forgebridge project set PATH --mode balanced --autonomy standard or
remove the project profile with forgebridge project remove PATH.
Local installation
ForgeBridge is packaged as an npm-compatible tarball because node-pty is a native dependency and
Playwright browser binaries are platform-specific. Nothing is published by the release scripts.
pnpm run package:artifact
pnpm run package:validate
.\scripts\install-windows.ps1 -PackagePath .\release\forgebridge-0.1.0-alpha.4.tgz -InstallChromium
The artifact includes a CycloneDX SBOM and a SHA-256 checksum. Validation installs the actual tarball in a disposable prefix and exercises the installed CLI, MCP stdio, filesystem, terminal, and headless browser paths. See installation and upgrade instructions.
Optional Windows autostart is available after installation through
configure-autostart-windows.ps1. It creates a current-user scheduled
task only after explicit local configuration and stores the least-privilege tunnel runtime key with
Windows DPAPI; the default installer still creates no startup entry.
Optional Windows UI Automation is disabled by default. Set windowsUiAutomation.enabled to true
in the local config to expose bounded semantic Windows element trees and control-pattern actions. It
requires an unlocked interactive desktop and never bypasses cross-user or elevation boundaries.
Focus-changing actions are durably deferred in BACKGROUND and GAMING profiles and require local
approval plus an explicit switch to NORMAL.
The agent never installs auto-start or a background service implicitly. Do not expose its local HTTP endpoint to a network interface.
Before any public alpha, complete the remaining external gates listed in the release-readiness audit, including a separate clean Windows VM run, artifact signing, and an independent security review. Live Secure MCP Tunnel/ChatGPT validation has already passed for the recorded Windows configuration.
Security
ForgeBridge is powerful by design. An approved arbitrary shell has the authority of the OS account running the agent. For containment, use a dedicated low-privilege account, Windows Sandbox/VM, or another OS-enforced isolation boundary. Read SECURITY.md before using the agent on sensitive systems.
License
Apache License 2.0. See LICENSE.
ForgeBridge MCP 질문
ForgeBridge MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add forgebridge -- npx -y forgebridge를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
ForgeBridge MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ForgeBridge가 개발 워크플로우에 어떤 도움을 주나요?
호환 가능한 AI 클라이언트를 통해 파일 시스템 편집, 대화형 터미널 액세스, Git 워크플로우 및 시맨틱 브라우저 테스트를 지원합니다.
ForgeBridge는 보안과 권한을 어떻게 관리하나요?
모든 동작을 검사하는 deny-first 권한 엔진을 사용하며, 경로를 허용된 루트로 제한하고 쓰기 승인에는 유효 시간을 설정합니다.
에이전트의 동작을 모니터링할 수 있는 방법이 있나요?
네, 로컬 Control Center를 통해 권한을 검토하고, 작업 및 세션을 추적하며, 감사 로그를 확인할 수 있습니다.