Provisionne un poste de travail de développement OpenCode reproductible et une pile MCP sur n'importe quelle machine Linux, localement ou via SSH.
Aussi connu sous simonmak-ascent/opencode-workbench, @simonmak-ascent/opencode-workbench
- Étoiles
- 1
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 5.0.1
- Dernier commit
- 2 nov. 2026
- Licence
- MIT
Qu'est-ce que opencode-workbench MCP ?
Provisionne un poste de travail de développement OpenCode reproductible et une pile MCP sur n'importe quelle machine Linux, localement ou via SSH.
Résumé généré à partir du README du projet
À propos du MCP server opencode-workbench
Les développeurs souhaitant déployer un environnement de développement standardisé et reproductible peuvent utiliser cet outil pour provisionner un poste de travail OpenCode complet sur n'importe quelle machine Linux. En exécutant le serveur localement ou via SSH, vous pouvez cloner une pile complète comprenant des configurations de poste de travail spécifiques, 76 Agent Skills réutilisables et 31 MCP servers configurés. L'installation est conçue pour être auto-documentée et récupérable, garantissant que votre environnement de développement reste cohérent sur différents matériels.
Le processus utilise un cycle de vie spécifique de découverte, de planification et d'application. Vous pouvez utiliser des outils tels que inspect_target pour auditer une machine, plan_clone pour prévisualiser les changements et apply_clone pour exécuter l'installation. Le serveur est conçu pour être résilient aux clés, ce qui signifie qu'il peut démarrer même sans clés de modèle, et il gère les identifiants en écrivant un fichier template plutôt qu'en manipulant directement des valeurs sensibles. Cela le rend adapté aussi bien au développement local qu'à la gestion de serveurs distants via SSH.
Ce que vous pouvez faire avec
- 1Cloner un poste de travail vers un serveur distantProvisionnez un environnement de développement OpenCode complet sur une machine Linux distante en utilisant des identifiants SSH.
- 2Auditer la préparation d'une machine cibleInspectez une machine Linux pour vérifier son système d'exploitation actuel, sa toolchain et sa configuration Docker avant le déploiement.
- 3Vérifier la réussite de la configuration de l'environnementExécutez un contrôle de validation pour vous assurer que le poste de travail cloné est pleinement fonctionnel et identifier d'éventuels identifiants manquants.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer opencode-workbench MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller opencode-workbench MCP dans Claude Code
$ claude mcp add opencode-workbench -- npx -y @simonmak-ascent/opencode-workbenchInstaller opencode-workbench MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"opencode-workbench": {
"command": "npx",
"args": [
"-y",
"@simonmak-ascent/opencode-workbench"
]
}
}
}Installer opencode-workbench MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"opencode-workbench": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@simonmak-ascent/opencode-workbench"
]
}
}
}Installer opencode-workbench MCP dans VS Code CLI
$ code --add-mcp '{"name":"opencode-workbench","type":"stdio","command":"npx","args":["-y","@simonmak-ascent/opencode-workbench"]}'Installer opencode-workbench MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"opencode-workbench": {
"command": "npx",
"args": [
"-y",
"@simonmak-ascent/opencode-workbench"
]
}
}
}Installer opencode-workbench MCP dans Codex
$ codex mcp add opencode-workbench -- npx -y @simonmak-ascent/opencode-workbenchInstaller opencode-workbench MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.opencode-workbench] command = "npx" args = ["-y", "@simonmak-ascent/opencode-workbench"]
Installer opencode-workbench MCP dans Gemini CLI
$ gemini mcp add -s user opencode-workbench npx -- -y @simonmak-ascent/opencode-workbenchInstaller opencode-workbench MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"opencode-workbench": {
"command": "npx",
"args": [
"-y",
"@simonmak-ascent/opencode-workbench"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblesimonmak-ascent/opencode-workbench is public and reachablegithub.com/simonmak-ascent/opencode-workbench ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-02github.com/simonmak-ascent/opencode-workbench ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @simonmak-ascent/opencode-workbenchRéussi
- Aucun avis critique dans le package ou ses dépendances100 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 150 msRéussi
README
Voir sur GitHubOpenCode Workbench
A reproducible, self-documenting, and recoverable OpenCode development workstation — configuration, agent skills, MCP stack, and an MCP server that clones the entire setup onto any Linux machine (locally or over SSH).
Homepage & remote MCP: https://opencode-workbench.simonmak.com · POST https://opencode-workbench.simonmak.com/mcp
Overview
This repository is the single source of truth for a complete cloud development workstation. Everything needed to rebuild from scratch is versioned here:
- Workstation configuration and automation
- OpenCode configuration (model, providers, MCP servers)
- Agent skills (76 reusable AI instructions across research, dev, data, science and ops)
- Operational prompts (disaster recovery, backup, security)
- Recovery procedures (playbook, checklist, gap analysis)
- Security governance (secret management, threat model)
- OpenCode sandbox (bubblewrap) — run the agent with a read-only system and no secret mounts
opencode-workbench— an MCP server that installs this profile on any Linux box
No important knowledge exists only in human memory.
Clone This Workbench to Another Linux Machine
Register the MCP server with OpenCode:
{
"mcp": {
"opencode-workbench": {
"type": "local",
"command": ["npx", "-y", "@simonmak-ascent/opencode-workbench"],
"enabled": true,
"timeout": 600000
}
}
}
Then ask the agent to run inspect_target → plan_clone → apply_clone { confirm: true } → verify_clone, for { "mode": "local" } or { "mode": "ssh", "host": "<your-box>", "user": "<your-user>" }. apply_clone is consent-gated: without confirm:true it returns a plan (components + privileged-command preview) and changes nothing. Run list_required_credentials to see which keys the box still needs and how to acquire them, and bash scripts/selftest/run-selftest.sh to verify it works. See mcp-server/README.md and docs/architecture/clone-mcp.md.
The clone is key-resilient: with no model key it still boots on the OpenCode Zen free floor, and MCP servers whose credentials are absent are disabled and reported (not left to fail at runtime).
The connector never reads or transmits secret values; it writes an empty ~/.env.workbench template for you to fill in.
Quick Start (≤ 5 minutes)
Fastest path: no box required — register the MCP server with
npx -y @simonmak-ascent/opencode-workbench (config in
Clone This Workbench); or provision a fresh box:
# Create a new build box
gh SWAS create --repo simonmak-ascent/opencode-workbench --machine basicLinux32gb
# Wait for postCreate (3-5 min) — installs everything automatically
# Then start coding:
opencode
Architecture
flowchart TB
AGENT["OpenCode agent"] -->|"npx @simonmak-ascent/opencode-workbench"| MCP["opencode-workbench MCP<br/>inspect · plan · apply · verify"]
REPO[("Git repo — single source of truth")] --> MCP
MCP -->|"local or SSH"| BOX["Target Linux box"]
BOX --> PROF["Workstation profile<br/>OpenCode CLI · 31 MCP servers · 76 skills · Docker infra"]
Clone lifecycle
apply_clone is consent-gated: without confirm: true it returns a plan and changes nothing.
sequenceDiagram
autonumber
participant A as OpenCode agent
participant M as opencode-workbench MCP
participant B as Target box (local or SSH)
A->>M: inspect_target
M-->>A: OS, toolchain, Docker, existing config
A->>M: plan_clone
M-->>A: components + privileged-command preview
A->>M: apply_clone { confirm: true }
M->>B: install components · write ~/.env.workbench template
B-->>M: result
A->>M: verify_clone
M-->>A: pass/fail + missing credentials
MCP tool surface
flowchart LR
A["OpenCode agent"] --> D["Discovery<br/>describe_workbench · inspect_target"]
A --> C["Clone<br/>plan_clone · apply_clone · verify_clone"]
A --> K["Components<br/>install · remove · update_component"]
A --> S["Credentials<br/>list_required_credentials · run_auth_flow"]
opencode-workbench/
├── mcp-server/ # opencode-workbench: clone this profile onto Linux
│ ├── src/ # inspect / plan / apply / verify, local + SSH
│ ├── test/ # unit tests (vitest)
│ └── README.md
├── connector.json # MCP connector manifest / registration snippet
├── plugins/ # memory.ts + doc-tools.ts OpenCode plugins
├── package.json # thin launcher for opencode-workbench (bin + prepare)
├── .devcontainer/ # build box definition & bootstrap
│ ├── devcontainer.json # Container image, features, ports, remoteEnv
│ ├── setup.sh # Post-create: installs opencode, MCPs, Docker infra
│ └── aliases.sh # Shell aliases sourced at runtime
├── .opencode/
│ └── skills/ # 76 agent skills, one directory per SKILL.md
├── vendor/ # Vendored MCP source code
│ ├── perplexity-agent-mcp/
│ └── browserless-mcp/
├── configs/ # Reference configurations
│ ├── mcp/ # MCP server inventory & architecture
│ ├── opencode/ # OpenCode settings documentation
│ ├── shell/ # Shell configuration
│ ├── git/ # Git configuration & hooks
│ └── providers/ # AI provider configuration
├── docs/ # Complete documentation system
│ ├── WORKBENCH_CHARTER.md # Governance: mission, principles, requirements
│ ├── security-model.md # Security architecture & threat model
│ ├── IMPROVEMENT_BACKLOG.md # Tracked improvements and fixes
│ ├── CHANGELOG_WORKBENCH.md # Append-only change history
│ ├── architecture/ # System documentation (incl. clone-mcp.md)
│ ├── recovery/ # Recovery procedures (4 docs)
│ ├── prompts/ # Operational prompt library (9 prompts)
│ └── backup-reports/ # Dated backup snapshots
├── scripts/ # Automation scripts
│ ├── backup/ # Master backup script
│ ├── inventory/ # Auto-generate inventories (software, env, MCP, OpenCode)
│ ├── security/ # Secret pattern scanner
│ ├── recovery/ # Recovery validation
│ └── maintenance/ # Config sync, routine tasks
├── .github/workflows/ # CI (docs, inventory, gitleaks, mcp-server)
├── opencode.json # OpenCode configuration (MCP servers)
├── AGENTS.md # OpenCode agent instructions
└── README.md # This file
What's Inside
| Category | Details |
|---|---|
| OpenCode | OpenCode 2 CLI, installed from the v2 channel (latest 2.x at clone time; inspect_target reports the version it found) · DeepSeek V4 Pro model · LSP enabled |
| MCP Servers | 31 configured (29 enabled, 2 disabled), 8 remote + 23 local |
| Agent Skills | 76 reusable skills in .opencode/skills/ |
| Versions | workbench.versions.json — every MCP server, plugin and skill resolved from its real upstream, regenerated and CI-checked |
| Infrastructure | PostgreSQL 16 (Docker), Browserless Chromium (Docker) |
| Tools | pandoc, jq, miller, sqlite3, GitHub CLI, Playwright Chromium |
| Prompts | 9 operational prompts in docs/prompts/ |
Workstation Governance
This workstation operates under a formal charter. Key principles:
- Single Source of Truth: Runtime must match repository. Drift is a bug.
- Secrets Never Touch Disk: All secrets flow through the build box Secrets.
- Immutable History: Changelog is append-only. Every change is traceable.
- Documentation Lives With Code: Docs describe the system as it is, not as imagined.
Read the full charter: docs/WORKBENCH_CHARTER.md
Backup Workflow
# Master backup — full inventory, security scan, commit prep
bash scripts/backup/run-master-backup.sh
# Quick backup — save state before risky operations
bash scripts/maintenance/sync-runtime-config.sh && \
git diff > /tmp/quick-backup-$(date +%Y%m%d).diff
Or use OpenCode prompts:
docs/prompts/RUN_MASTER_BACKUP.md— execute backup via AIdocs/prompts/QUICK_BACKUP.md— rapid state preservation
Recovery Workflow
Assume the build box is deleted. Only Git repo + build box Secrets survive.
# 1. Create new build box
gh SWAS create --repo simonmak-ascent/opencode-workbench --machine basicLinux32gb
# 2. Wait for automation (3-5 min)
# 3. If needed (usually done by setup.sh):
npx playwright install chromium
# Vercel MCP uses VERCEL_ACCESS_TOKEN (token auth — no OAuth step)
# 4. Validate recovery
bash scripts/recovery/validate-recovery.sh
Full details: docs/recovery/RECOVERY_PLAYBOOK.md
MCP Architecture
| Type | Count | Notes |
|---|---|---|
| Remote | 9 | context7, gh_grep, vdd, exa, cloudflare, clerk, vercel (token auth), sentry, stripe |
| Local | 26 | npm / vendored / binary stdio servers |
Totals: 31 configured (29 enabled, 2 disabled: google-search, google-workspace).
See: docs/architecture/mcp-inventory.md
Secrets Management
All secrets stored in the build box Secrets. Never in repository files.
| # | Secret | Used By |
|---|---|---|
| 1 | DEEPSEEK_API_KEY |
OpenCode (primary model) |
| 2 | OPENCODE_API_KEY |
OpenCode Zen / Console Go providers |
| 3 | SIMONMAK_ASCENT_PAT |
GitHub MCP, shadcn MCP, gh |
| 4 | PERPLEXITY_API_KEY |
Perplexity MCP |
| 5 | BRAVE_API_KEY |
Brave Search MCP |
| 6 | BROWSERLESS_TOKEN |
Browserless MCP + container |
| 7 | SENTRY_AUTH_TOKEN |
Sentry MCP |
| 8 | VERCEL_ACCESS_TOKEN |
Vercel MCP (token auth) |
Additional keys for opt-in servers (EXA_API_KEY, CLOUDFLARE_API_TOKEN,
STRIPE_SECRET_KEY, SURREAL_*, ALIBABA_CLOUD_*, AZURE_*, FIRECRAWL_API_KEY,
FRED_API_KEY, COMPANIES_HOUSE_API_KEY) are catalogued in
docs/architecture/secrets.md — never by value.
See: docs/architecture/secrets.md
Documentation Index
| Document | Purpose |
|---|---|
docs/WORKBENCH_CHARTER.md |
Mission, principles, governance |
docs/security-model.md |
Security architecture, threat model, incident response |
docs/IMPROVEMENT_BACKLOG.md |
Tracked improvements and technical debt |
docs/CHANGELOG_WORKBENCH.md |
Complete change history |
docs/architecture/ |
System documentation (10 inventory docs) |
docs/recovery/ |
Recovery playbook, disaster recovery, checklist, gap analysis |
docs/prompts/ |
9 operational prompts with index |
docs/backup-reports/ |
Dated backup snapshots |
Adding to the Workbench
- MCP Server: Add npm package to
.devcontainer/setup.sh, add toopencode.json, document indocs/architecture/mcp-inventory.md - Agent Skill: Create
.opencode/skills/<name>/SKILL.md, follow naming convention - Tool: Add to
scripts/bootstrap-tools.sh - Prompt: Create in
docs/prompts/, updateprompt-index.md - After any change: Update
CHANGELOG_WORKBENCH.md, run master backup
Recovery Score: 94/100
Validated disaster recovery within < 10 minutes using repository + build box Secrets alone.
Use with Context7
Up-to-date OpenCode Workbench documentation is indexed on Context7, so coding agents can pull it into context on demand. With the Context7 MCP server or ctx7 CLI installed, name the library in your prompt:
use library /simonmak-ascent/opencode-workbench for API and docs
License
MIT — see LICENSE.
A tool by Simon Mak.
If this saves you time, a ⭐ on GitHub helps others find it.
Questions sur opencode-workbench MCP
Comment ajouter opencode-workbench MCP à Claude Code ?
Exécutez claude mcp add opencode-workbench -- npx -y @simonmak-ascent/opencode-workbench dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter opencode-workbench MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment puis-je cloner cet environnement de travail sur une autre machine Linux ?
Enregistrez le MCP server auprès d'OpenCode et utilisez l'agent pour exécuter la séquence inspect_target, plan_clone, apply_clone et verify_clone.
Le processus de clonage est-il sécurisé ?
Oui, la commande apply_clone nécessite un consentement ; elle ne retournera qu'un plan sans effectuer de modifications, à moins que vous ne fournissiez explicitement une confirmation.
Comment le serveur gère-t-il les identifiants sensibles ?
Le connecteur ne lit pas et ne transmet pas de valeurs secrètes ; il crée plutôt un fichier template vide que vous remplissez manuellement.