dev-mcp-suite

mcp
Guvenlik Denetimi
Basarisiz
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.

SUMMARY

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.

README.md

Dev MCP Suite 🚀

Give your AI Coding Assistant Permanent Brain Power & Zero Memory Loss.

CI
npm version
npm downloads
license
node
Saweria

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:

  1. Local Offline Vector Search (v1.8.0) — Set MCP_LOCAL_EMBED=true to use the built-in, zero-dependency 384-dimensional term-frequency hashing vector engine. Sub-millisecond execution, zero network requests, 100% private.
  2. Remote Embeddings (Optional) — Connect any OpenAI-compatible /v1/embeddings endpoint (OpenAI, Cloudflare Workers AI, Ollama, LM Studio, 9router, OpenRouter).
  3. LLM Reranking (Optional) — Hybrid keyword pre-filter followed by LLM reranking for high-precision recall.
  4. 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_create to create a safe recovery point.
  • While Coding: Run memory_save to store architectural decisions, and pack_audit before committing.
  • Session End / Compaction: Run journal_handoff so 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-memory or project directory).
  • Zero Telemetry: No tracking, no user accounts, no phoning home.
  • Network Isolation Ready: Set MCP_DETERMINISTIC_FALLBACK=true for 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):

Saweria


📄 License

MIT © Verry Simatupang — see LICENSE.

Yorumlar (0)

Sonuc bulunamadi