dev-mcp-suite
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 96 GitHub stars
Code Basarisiz
- fs module — File system access in .github/workflows/ci.yml
- fs.rmSync — Destructive file system operation in _testkit/harness.mjs
- process.env — Environment variable access in _testkit/harness.mjs
- os.homedir — User home directory access in armada/server.js
- process.env — Environment variable access in armada/server.js
- network request — Outbound network request in armada/server.js
- fs.rmSync — Destructive file system operation in backfill-sessions-v2.mjs
- os.homedir — User home directory access in backfill-sessions-v2.mjs
- process.env — Environment variable access in bin/_meta.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Four local, file-based MCP servers for solo devs/vibecoders: persistent memory, session handoff/resume, file checkpoints, token-efficient project briefings. Works with any MCP client.
Dev MCP Suite 🚀
Give your AI Coding Assistant Permanent Brain Power & Zero Memory Loss.
Published on npm as @maximalabs/dev-mcp-suite.
😩 Sound Familiar?
"You spent 45 minutes explaining your database schema and architecture to your AI agent. Then... 'Context window compacted' or session restarted. Boom. Your AI forgot everything and started hallucinating variable names."
Stop re-pasting context over and over.
Dev MCP Suite is a suite of four local, zero-telemetry MCP (Model Context Protocol) servers built for solo developers and vibe coders. It equips your favorite AI agent (Codex CLI, Hermes Agent, Google Antigravity, Claude Code, Cursor, Windsurf) with permanent memory, anti-compaction handoffs, git-safe checkpoints, and offline vector search.
⚡ Before & After Dev MCP Suite
| Without Dev MCP Suite 🥱 | With Dev MCP Suite ⚡ |
|---|---|
| Re-explaining project setup every time session resets | One-command journal_resume recovers context instantly |
| AI forgets architectural decisions and preferences | Obsidian-compatible Markdown vault retains knowledge permanently |
| Wasted git commits just to save temporary experiments | Git-independent checkpoint_create & instant rollback |
| Accidental secret/API key leaks committed to GitHub | Built-in pack_audit flags missing .gitignore & leaked keys |
| Locked into a proprietary hosted backend | 100% Local-first, zero cloud lock-in, zero telemetry |
⚡ 10-Second Quickstart
Automatically configure all installed AI tools (Codex CLI, Claude Code, Cursor, Windsurf, Hermes, Antigravity) with 1 command:
npx -y @maximalabs/dev-mcp-suite init
Or test a single server right now without installing:
npx -y -p @maximalabs/dev-mcp-suite project-memory-mcp --help
🛠️ The 4 Superpowers (MCP Servers)
| Server | Superpower | Key Tools |
|---|---|---|
🧠 project-memory |
Obsidian-Grade Knowledge Vault: Persistent Markdown notes, wiki-links ([[note]]), MOC generation, zero-dependency local 384-d vector search (MCP_LOCAL_EMBED=true), multi-agent swarm stream, and autonomous background git observer (memory_auto_index). |
memory_save, memory_recall, memory_list, memory_get, memory_link, memory_moc, memory_graph, memory_dedup, memory_broadcast, memory_swarm_timeline, memory_auto_index |
📜 devjournal |
Anti-Compaction Session Timeline: Logs progress, saves handoffs, restores full context, and compresses session logs to cut token costs ~90%. | journal_log, journal_handoff, journal_resume, journal_timeline, journal_search, journal_compress, journal_clear_handoff |
🛡️ checkpoint |
Git-Independent Snapshots: Take 1-second file snapshots before risky AI refactors. Compare diffs and revert instantly without touching your git tree. | checkpoint_create, checkpoint_list, checkpoint_diff, checkpoint_restore, checkpoint_delete |
🔍 context-pack |
Autonomous Agent OS: Token-efficient briefings, dependency blast-radius analysis (pack_impact), self-healing preflight checks (pack_guard), live log telemetry (pack_telemetry), predictive contract diff simulation (pack_predictive_diff), and security auditing (pack_audit). |
pack_overview, pack_tree, pack_outline, pack_search, pack_audit, pack_impact, pack_guard, pack_telemetry, pack_predictive_diff |
🛰️ armada (opsional) |
Fleet Ops Control Plane: Watch heartbeats and enqueue policy-gated jobs on many hosts through an Armada bus — outbound-only, no SSH fan-in. Host policy grants/denies every job (allowlist → user → root → docker sandbox). Needs ARMADA_BUS_URL + ARMADA_BUS_TOKEN; not auto-wired by init since it points at YOUR fleet. |
fleet_health, fleet_jobs, job_post, job_status, job_watch, job_tail, job_cancel, bus_note, bus_read |
🧠 Intelligent Local-First Semantic Search
memory_recall automatically selects the best available search engine on your machine:
- Local Offline Vector Search (
v1.8.0) — SetMCP_LOCAL_EMBED=trueto use the built-in, zero-dependency 384-dimensional term-frequency hashing vector engine. Sub-millisecond execution, zero network requests, 100% private. - Remote Embeddings (Optional) — Connect any OpenAI-compatible
/v1/embeddingsendpoint (OpenAI, Cloudflare Workers AI, Ollama, LM Studio, 9router, OpenRouter). - LLM Reranking (Optional) — Hybrid keyword pre-filter followed by LLM reranking for high-precision recall.
- Keyword Fallback — Always-available offline fallback if no network or API keys exist.
🔌 Plug & Play with Any MCP Client
1. Codex CLI (~/.codex/config.toml)
[mcp_servers.project-memory]
command = "npx"
args = ["-y", "-p", "@maximalabs/dev-mcp-suite", "project-memory-mcp"]
[mcp_servers.devjournal]
command = "npx"
args = ["-y", "-p", "@maximalabs/dev-mcp-suite", "devjournal-mcp"]
[mcp_servers.checkpoint]
command = "npx"
args = ["-y", "-p", "@maximalabs/dev-mcp-suite", "checkpoint-mcp"]
[mcp_servers.context-pack]
command = "npx"
args = ["-y", "-p", "@maximalabs/dev-mcp-suite", "context-pack-mcp"]
2. Hermes Agent (~/.hermes/config.yaml)
mcp_servers:
project-memory:
command: project-memory-mcp
env:
MCP_LOCAL_EMBED: "true"
devjournal:
command: devjournal-mcp
checkpoint:
command: checkpoint-mcp
context-pack:
command: context-pack-mcp
3. Google Antigravity CLI / Cursor / Claude Code (mcp.json)
{
"mcpServers": {
"project-memory": { "command": "project-memory-mcp", "env": { "MCP_LOCAL_EMBED": "true" } },
"devjournal": { "command": "devjournal-mcp" },
"checkpoint": { "command": "checkpoint-mcp" },
"context-pack": { "command": "context-pack-mcp" }
}
}
4. Armada Fleet MCP (opsional — butuh fleet Armada sendiri)
armada-mcp tidak dipasang otomatis oleh init karena ia menunjuk ke bus
milikmu. Tambahkan manual ke klien yang perlu akses fleet:
{
"mcpServers": {
"armada": {
"command": "npx",
"args": ["-y", "-p", "@maximalabs/dev-mcp-suite", "armada-mcp"],
"env": {
"ARMADA_BUS_URL": "https://bus.example.com",
"ARMADA_BUS_TOKEN": "<token-agen>",
"ARMADA_AGENT": "claude-code"
}
}
}
}
Tanpa env, server membaca ~/.config/armada/agent.env — file yang sama
yang dipakai armada CLI,
jadi kredensial berbagi satu tempat. ARMADA_BUS_URL adalah origin bus
tanpa suffix /bus. Ingat: grant dieksekusi oleh policy di host target —
mode user/root/sandbox hanya jalan bila host mengizinkan agenmu.
👉 See detailed client setup guides in docs/clients/.
🚀 Daily Solo Developer Workflow
- Session Start: Run
pack_overview+journal_resume+memory_recall "<topic>"to get oriented in seconds. - Before Risky Changes: Run
checkpoint_createto create a safe recovery point. - While Coding: Run
memory_saveto store architectural decisions, andpack_auditbefore committing. - Session End / Compaction: Run
journal_handoffso your next session picks up right where you left off.
📊 Utility CLIs Included
Install globally with npm i -g @maximalabs/dev-mcp-suite to access built-in maintenance tools:
stats— View total notes, journal activity, and storage stats across all projects (stats --json).prune— Safely clean up temporary project scratch files (prune --yes).provider-smoke— Probe configured LLM providers (chat & embedding endpoints) for health and latency.
🔒 Privacy & Local-First Philosophy
- Zero Cloud Backend: Everything is saved locally as plain Markdown & JSON files on your hard drive (
~/.ai-shared-memoryor project directory). - Zero Telemetry: No tracking, no user accounts, no phoning home.
- Network Isolation Ready: Set
MCP_DETERMINISTIC_FALLBACK=truefor 100% air-gapped, offline operations. - See detailed privacy and data flow documentation.
☕ Support / Donasi
Jika @maximalabs/dev-mcp-suite membantu alur kerja pengkodean Anda dan menghemat waktu Anda, dukung pengembangan proyek open-source ini melalui Saweria (QRIS, GoPay, DANA, OVO, ShopeePay):
📄 License
MIT © Verry Simatupang — see LICENSE.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi