AI istemcileri üzerinden dosya sistemi düzenleme, terminal erişimi, Git iş akışları ve semantik tarayıcı testi için izin tabanlı yerel bir agent sağlar.
Ayrıca bilinen adı t1ktakdev/ForgeBridge
- Yıldızlar
- 1
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.0-alpha.4
- Son commit
- 21 Eyl 2026
- Lisans
- Apache-2.0
ForgeBridge MCP nedir?
AI istemcileri üzerinden dosya sistemi düzenleme, terminal erişimi, Git iş akışları ve semantik tarayıcı testi için izin tabanlı yerel bir agent sağlar.
Özet, projenin README dosyasından oluşturuldu
ForgeBridge MCP sunucusu hakkında
ForgeBridge, AI istemcilerine iş istasyonlarına kontrollü erişim yetkisi vermek isteyen geliştiriciler için tasarlanmış, izin tabanlı yerel bir agent olarak çalışır. Dosya sistemi düzenleme, terminal etkileşimi, Git iş akışları ve semantik tarayıcı testini kolaylaştırır. Sunucu yerel olarak çalışır ve stdio üzerinden veya ChatGPT gibi web tabanlı arayüzler için OpenAI Secure MCP Tunnel kullanarak giden bir HTTPS yolu aracılığıyla AI istemcilerine bağlanabilir.
Kullanıcılar; izinleri gözden geçirmek, aktif işleri izlemek ve denetim izlerini incelemek için yerel bir Control Center aracılığıyla agent'ı yönetirler. Sistem, tüm eylemlerin yetkilendirilmiş standart kök dizinler içinde kalmasını sağlamak için 'önce reddet' (deny-first) izin motorunu kullanır. Geliştiriciler, proje yığını, barındırılan işletim sistemi ve Git durumu hakkında hızlıca bilgi edinmek için project_inspect aracını kullanabilirler. Yüksek düzeyde otomasyon sağlarken, yazma işlemleri için onay gerektirerek ve tarayıcı oturumlarını varsayılan olarak izole tutarak güvenliği korur.
Neler yapabilirsiniz
- 1Otomatik proje ortamı keşfiBir AI istemcisi, mevcut proje yığınını, kabuğu (shell) ve Git durumunu tanımlamak için tek bir komut kullanabilir.
- 2Kontrollü dosya sistemi ve Git yönetimiGeliştiriciler, bir AI'nın belirli proje sınırları dahilinde rutin kodlama görevlerini ve Git işlemlerini gerçekleştirmesine izin verebilirler.
- 3Denetimli terminal yürütmeKullanıcılar, etkileşimli terminal oturumlarını ve uzun süreli işleri özel bir arayüz üzerinden izleyebilir ve onaylayabilirler.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ForgeBridge MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleForgeBridge MCP'yi Claude Code içine yükleyin
$ claude mcp add forgebridge -- npx -y forgebridgeForgeBridge MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"forgebridge": {
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}ForgeBridge MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"forgebridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}ForgeBridge MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"forgebridge","type":"stdio","command":"npx","args":["-y","forgebridge"]}'ForgeBridge MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"forgebridge": {
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}ForgeBridge MCP'yi Codex içine yükleyin
$ codex mcp add forgebridge -- npx -y forgebridgeForgeBridge MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.forgebridge] command = "npx" args = ["-y", "forgebridge"]
ForgeBridge MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user forgebridge npx -- -y forgebridgeForgeBridge MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"forgebridge": {
"command": "npx",
"args": [
"-y",
"forgebridge"
]
}
}
}Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirt1ktakdev/forgebridge is public and reachablegithub.com/t1ktakdev/forgebridge ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorforgebridge names t1ktakdev/forgebridge as sourcenpmjs.com/package/forgebridge ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-21github.com/t1ktakdev/forgebridge ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from forgebridgeGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok106 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
ForgeBridge MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add forgebridge -- npx -y forgebridge komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
ForgeBridge MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
ForgeBridge geliştirme iş akışım için neler yapabilir?
Uyumlu AI istemcileri aracılığıyla dosya sistemi düzenleme, etkileşimli terminal erişimi, Git iş akışları ve semantik tarayıcı testi yapılmasına olanak tanır.
ForgeBridge güvenlik ve izinleri nasıl yönetiyor?
Her işlemin kontrol edildiği, yolların yalnızca izin verilen kök dizinlerle sınırlandırıldığı ve yazma onaylarının belirli bir süreyle kısıtlandığı 'önce reddet' (deny-first) tabanlı bir izin motoru kullanır.
Agent'ın ne yaptığını izlemenin bir yolu var mı?
Evet, izinleri gözden geçirmek, işleri ve oturumları takip etmek ve denetim izlerini incelemek için yerel bir Control Center içerir.