Ekipler ve kodlama ajanları için Docker Compose dosyalarından self-hosted önizleme ortamlarını yönetir.
Ayrıca bilinen adı Flosk6/Spawner, spawner-cli
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 13 Kas 2026
- Lisans
- Apache-2.0
Spawner MCP nedir?
Spawner bir MCP sunucusudur. Ekipler ve kodlama ajanları için Docker Compose dosyalarından self-hosted önizleme ortamlarını yönetir.
Özet, projenin README dosyasından oluşturuldu
Spawner MCP sunucusu hakkında
Spawner, yazılım ekipleri ve kodlama ajanları için self-hosted önizleme ortamlarını yönetmeyi mümkün kılar. Mevcut Docker Compose dosyalarını kullanarak her git branch'i için uygulamaların geçici kopyalarını oluşturur; her kopyaya özel URL'ler, veritabanları ve loglar sağlar. Bu sistem, Kubernetes gerektirmeden kendi sunucunuzda çalışır ve böylece izole test alanlarına ihtiyaç duyan geliştiriciler için hafif bir alternatif sunar.
Kullanıcılar sistemle bir web paneli, komut satırı arayüzü veya Claude Code, Codex ve Cursor gibi istemciler için tasarlanmış bir MCP server aracılığıyla etkileşime girer. Kurulum için Docker yüklü, Ubuntu veya Debian çalıştıran özel bir sunucu ve bir wildcard DNS kaydı gereklidir. Ortamları yönetmek için spawner_up, spawner_logs ve spawner_exec gibi araçlar kullanılır. Kaynak tasarrufu sağlamak amacıyla sistem, kullanılmayan ortamları otomatik olarak uyku moduna alır ve disk kullanımını en aza indirmek için paylaşılan katmanları kullanır.
Neler yapabilirsiniz
- 1Branch önizlemelerini dağıtınBir yapay zeka ajanı, henüz commit edilmemiş değişiklikleri test etmek için yerel bir worktree üzerinden tam bir uygulama yığını ayağa kaldırabilir.
- 2Servis hatalarını ayıklayınGeliştiriciler, çökmeleri gidermek için çalışan bir konteynerden belirli hata loglarını ve stack trace bilgilerini alabilirler.
- 3Uzak komutlar çalıştırınBir önizleme ortamı içindeki belirli bir servis içinde doğrudan veritabanı migrasyonları veya diğer terminal komutlarını çalıştırabilirsiniz.
- 4Geçici bağlantılar paylaşınPaydaşların resmi bir hesaba ihtiyaç duymadan önizlemeyi görüntüleyebilmeleri için geçici bir erişim bağlantısı oluşturun.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Spawner MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleSpawner MCP'yi Claude Code içine yükleyin
$ claude mcp add spawner -- npx -y spawner-cliSpawner MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"spawner": {
"command": "npx",
"args": [
"-y",
"spawner-cli"
]
}
}
}Spawner MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"spawner": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"spawner-cli"
]
}
}
}Spawner MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"spawner","type":"stdio","command":"npx","args":["-y","spawner-cli"]}'Spawner MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"spawner": {
"command": "npx",
"args": [
"-y",
"spawner-cli"
]
}
}
}Spawner MCP'yi Codex içine yükleyin
$ codex mcp add spawner -- npx -y spawner-cliSpawner MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.spawner] command = "npx" args = ["-y", "spawner-cli"]
Spawner MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user spawner npx -- -y spawner-cliSpawner MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"spawner": {
"command": "npx",
"args": [
"-y",
"spawner-cli"
]
}
}
}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şilebilirflosk6/spawner is public and reachablegithub.com/flosk6/spawner ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorspawner-cli names flosk6/spawner as sourcenpmjs.com/package/spawner-cli ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for spawner-clinpmjs.com/package/spawner-cli/v/2.2.1#provenance ↗Geçti
- 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-11-12github.com/flosk6/spawner ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from spawner-cliGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- 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
Spawner
Spawner is an open source, self-hosted preview environment manager: a copy of your app for each git branch, on your own server, with its own URLs, database and logs, for teams and their coding agents.
Website · Documentation · Compare · Changelog · Releases · npm
Spawner builds preview environments (also called review apps or ephemeral environments) from your project's Docker Compose file, without Kubernetes. Developers, reviewers and coding agents start one from a branch, or from a worktree with its uncommitted changes, then open it, run commands in it, read its logs, share it and delete it. Environments nobody uses go to sleep, so many fit on one server. Free under Apache-2.0.
Status: out of beta since 2.1.0. Only the latest release gets fixes, and the dashboard updates a server in one click.
$ cd ~/code/blog-feat-login # an agent's worktree, branch feat/login
$ spawner up --wait
feat-login (blog) is ready
web https://feat-login--blog.preview.example.com
api https://api--feat-login--blog.preview.example.com
$ spawner exec -i feat-login db -- mysql -uapp -papp app < fixtures.sql
$ spawner logs feat-login api --errors
$ spawner share feat-login # a link for someone without an account
$ spawner down feat-login
Quick start
On a server dedicated to previews (Ubuntu 22.04 or 24.04, Debian 12, amd64 or arm64; at least 4 GiB of memory, 8 GiB or more advised), with a DNS record *.preview.example.com pointing to it:
curl -fsSL https://github.com/Flosk6/Spawner/releases/latest/download/install.sh | sudo bash
The installer asks for the domain, an e-mail and your DNS provider (for one wildcard certificate), installs Docker if needed, starts Spawner, and prints the link that creates the first admin account. Then, on your machine (Node.js 20 or later), in a project:
npm install -g spawner-cli
spawner login https://spawner.preview.example.com
spawner init
spawner init writes .spawner/ (a manifest and a Docker Compose file, to adjust), offers to add the instructions for coding agents, and prints the project's slug. An admin adds the project in the dashboard (Projects, New project): that slug, the repository, and the directory of .spawner/ in a monorepo. Then spawner up --wait starts the environment of the branch. The quick start goes through each step, and the examples (Node.js and PostgreSQL; Laravel, Next.js and MySQL) are ready to deploy.
How it works
flowchart LR
clients["browser, agent, CLI"] --> traefik["Traefik on *.preview.example.com"]
traefik --> spawner["spawner.preview.example.com<br>dashboard and API"]
traefik -.->|"checks access to protected URLs"| spawner
traefik --> env1["feat-login--blog.preview.example.com<br>web, api, db on their own network"]
traefik --> env2["main--blog.preview.example.com<br>web, api, db on their own network"]
A project describes its environment in its repository, in .spawner/: a manifest that names its URLs and its seed, and a regular Docker Compose file.
# .spawner/spawner.yaml
version: 1
project: blog
exposures:
- { name: web, service: web, port: 3000 }
- { name: api, service: api, port: 8000 }
seed:
- { service: api, run: [php, artisan, migrate, --seed, --force] }
For each environment, Spawner checks out the branch or receives the worktree, checks the compose file against a security policy, builds and starts it on its own Docker network, seeds it, and routes its URLs through Traefik with HTTPS. Updates keep the data. Every change is a job with a live log, whether it comes from the dashboard, the CLI, the MCP server or the API.
For coding agents
An agent tests its own work in a real environment, from its worktree, without pushing:
spawner up --wait --json: commands print JSON with--jsonand exit with stable codes (4: the environment failed, with the end of the build log; 6: quota or capacity reached; 7:.spawner/refused, with what to fix);spawner url --with-tokengives the header that opens protected URLs, for curl or Playwright;spawner execruns a command in any service;spawner logs --errorskeeps the error lines, stack traces whole;spawner statussays which service crashed and why;spawner mcpis an MCP server for Claude Code, Codex, Cursor and other clients (claude mcp add spawner -- spawner mcp), with nine tools:spawner_up,spawner_status,spawner_list,spawner_logs,spawner_exec,spawner_stats,spawner_url,spawner_shareandspawner_down;- each agent on its own branch gets its own environment and database; agents deploying at once do not get in each other's way.
See coding agents and the CLI.
Many environments on one server
- Sleep: after 2 hours (by default) without a visit or an action, an environment's containers stop; the next visit to a protected URL wakes it up within seconds.
- Shared layers: environments share their base images and dependencies; each one only adds its code and build output (about 4 MiB for the Laravel example). Spawner warns about Dockerfiles that prevent it: see making environments cheap.
- Capacity: Spawner says how many more environments of each project fit, from what they really use, and refuses one that does not fit.
- Lifetime and quotas: by default, environments expire after 72 hours unless someone deploys them again, and each person may own 5. Spawner cleans up what deleted environments leave, and nothing else.
Supervision
Each environment has its logs (by service, errors only, live), the CPU and memory of each service over time, its disk, a timeline of crashes, out-of-memory kills and failing healthchecks, and a terminal into any service; a deleted one stays readable for 7 days. Admins see the server: alerts, 30 days of history, every container, and how many more environments fit.
Security
Branches run unreviewed code: compose files are checked against an allowlist (no host mounts, privileged containers, host network or Docker socket), each environment has its own network, Traefik has no Docker socket, and the server is meant for previews only. Accounts have no passwords (invitations and passkeys, GitHub optional); tokens have scopes and expiries; previews are protected by default, and Spawner's cookies never reach the applications. An audit trail records who did what. No telemetry: on its own, Spawner only asks GitHub for new releases (SPAWNER_UPDATE_CHECK=false turns that off). See security.
What Spawner does not do
One installation runs previews on one server, from Docker Compose: no production, no Kubernetes, no cluster, and no environment opened by itself for a pull request (CI calls spawner up, see the CI guide). See the whole list, and the comparison with other tools.
Documentation
- Quick start: from a fresh install to the first environment
- Installing: requirements, DNS providers, options, upgrades, removal
- Concepts: projects, environments, jobs, lifecycle, access, limits
- The manifest:
.spawner/, its rules, and what makes environments cheap - The CLI and the MCP server: commands, JSON outputs, exit codes, MCP tools
- Coding agents: Claude Code, Codex, Cursor
- Pull requests in CI: previews from GitHub Actions and GitLab CI
- Examples and troubleshooting
- Security, operations (backups, disk, monitoring), configuration (every setting)
- Architecture: how Spawner is built, for contributors
Development
apps/
├── api/ NestJS, Prisma (PostgreSQL): the API and the environment engine
├── cli/ The spawner CLI and MCP server, bundled into one file
└── web/ Vue 3, Vite, Tailwind CSS, PrimeVue
packages/
├── core/ Manifest, compose policy and rendering (pure, shared with the CLI)
├── types/ API types shared by the web app and the CLI
└── utils/ Git input validators
examples/ Projects ready to deploy
scripts/ End-to-end tests, the capacity check, the release
Requirements: Docker with Compose v2, Node.js 22 and pnpm 8.
pnpm install && pnpm build
cp .env.example .env # set SPAWNER_DATA_DIR to an absolute path
docker compose up -d --build # Postgres, Traefik, Spawner: http://spawner.localtest.me
docker logs spawner # the link that creates the first admin account
pnpm dev # or the API on :3000, the web app on :8080, hot reload
pnpm lint && pnpm typecheck && pnpm test
scripts/e2e-engine.sh # end to end: a local stack, the API, the CLI and MCP
Every subdomain of localtest.me resolves to 127.0.0.1. Over plain HTTP, browsers allow passkeys on localhost only: a local install lets invitations log in without one. See scripts for the tests.
Contributing
Issues are welcome: bugs, questions and ideas. Pull requests from outside are not accepted for now; see contributing. Report vulnerabilities privately: security policy.
License
Apache-2.0: free to use, modify and distribute, commercially too. Copyright 2025-2026 Flosk6.
Spawner MCP soruları
Spawner MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add spawner -- npx -y spawner-cli komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Spawner 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.
Spawner nedir?
Spawner, her bir git branch'i için kendi sunucunuzda uygulamanızın bir kopyasını oluşturan, açık kaynaklı ve self-hosted bir önizleme ortamı yöneticisidir.
Spawner için Kubernetes gerekir mi?
Hayır, Spawner, Kubernetes'e ihtiyaç duymadan projenizin Docker Compose dosyasını kullanarak önizleme ortamları oluşturur.
Kodlama ajanları Spawner kullanabilir mi?
Evet, Spawner; Claude Code, Codex ve Cursor gibi kodlama ajanlarının ortamları yönetebilmesi için özel bir MCP server sağlar.