Denvora Groundwork
Queries the live npm registry (registry.npmjs.org) for package metadata: checks whether a package exists, flags typosquatted/lookalike names, verifies that a specific version has been published, and reports whether TypeScript declarations are bundled, provided by DefinitelyTyped, or absent. It can also fetch package tarballs into an isolated in-memory sandbox (without executing install scripts) to statically analyze exported symbols and suggest the closest real export names via Levenshtein ranking when an API is mistyped.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Ground your AI before it builds.
Deterministic verification and spec-driven planning MCP server for AI coding assistants.
💡 Why Groundwork?
AI coding assistants sound convincing even when they are guessing. They hallucinate nonexistent npm methods, use deprecated parameters, start coding before understanding user constraints, and risk exposing sensitive credentials.
Denvora Groundwork is an open-source Model Context Protocol (MCP) server that equips AI assistants with deterministic ground truth:
Verify (Facts over Hallucinations): True static AST analysis on
.d.tsdeclaration files, live npm registry metadata, typosquatting alarms, and OSV vulnerability scanning. Verdicts are strictly three-state:verified,not_found, orunverifiable— never a guess.Plan (Spec-Driven Development): Bilingual (Indonesian & English) brainstorming frameworks, PRD Blueprint templates, plan completeness checks, and atomic slice task ordering.
Secret & Privacy Shield: Absolute protection for user privacy. Rejects queries targeting
.env, credentials, SSH/AWS keys, and automatically redacts API keys into[REDACTED_SECRET].Zero API Keys & Zero LLM Calls: Operates 100% deterministically and locally via stdio.
Related MCP server: pkgguard
🏛️ System Architecture
🛠️ The 10 Public Tools
All tools conform to the stable public schema groundwork/1.
🔍 Verify Module (npm / TypeScript AST Engine)
Tool | What It Does | Verdicts / Evidence |
| Checks if an npm package exists, detects typosquat lookalike names, verifies version publication, and inspects TypeScript declaration types ( |
|
| Downloads package tarball into an isolated memory sandbox, extracts |
|
| Uses Levenshtein distance ranking to recommend the closest real exported symbol names when an AI or developer mistypes an API. | Nearest ranked symbol exports |
| Queries the live Open Source Vulnerabilities database ( | Advisory list & CVE IDs |
| Inspects local | Local package version & export AST |
📋 Plan Module (Spec-Driven Development Engine)
Tool | What It Does | Outputs |
| Generates at most 3 focused clarifying questions, scope reduction frameworks (MoSCoW, Smallest Lovable v1), and defaults. Automatically skips questions if user context is already known. Bilingual (EN/ID). |
|
| Generates structured SDD skeletons ( | Bilingual sections & markdown skeleton |
| Quality gate for project plans: checks for missing sections, detects ambiguous words ("fast", "easy", "bagus") lacking measurable metrics, verifies non-goals, and flags leaked API keys. |
|
| Parses markdown task lists with checkboxes ( | Next task, blocked tasks, deadlock detection |
⚡ Core Status Tool
groundwork_status: Reports runtime invariants, active security shield boundaries, and transport health over stdio.
🛡️ Secret & Privacy Shield
User security and confidentiality are top priorities. Denvora Groundwork enforces hard technical boundaries:
Strict File Blacklist: The server strictly rejects queries targeting sensitive files:
.env,.env.*,.env.local,.env.productioncredentials.json,client_secrets.json,service-account*.json.npmrc,.git-credentials,.netrcid_rsa,id_ed25519,*.pem,*.key,*.keystore,*.pfx,*.p12Sensitive directories:
~/.ssh,~/.aws,~/.gnupg
Path Traversal Protection: Input package names are strictly validated (
isValidPackageName); path traversals like../../.envare immediately blocked.Credential Auto-Redaction: Any API keys (
sk-...,ghp_...,AKIA..., Bearer tokens) or passwords in plan documents or arguments are automatically replaced with[REDACTED_SECRET].Zero Code Execution: Groundwork never runs
npm install, post-install hooks, orrequire()on downloaded tarballs.Host Allowlist: HTTPS network requests are restricted exclusively to
registry.npmjs.organdapi.osv.dev.
See SECURITY.md for our complete security policy and reporting guidelines.
🚀 Quickstart & Installation
Groundwork runs locally on your machine over standard stdio transport. You can install and run it using either Plan A (Global Instant) or Plan B (Local Clone):
📦 Choose Your Installation Plan
Method | Best For | Prerequisites | Command |
Plan A: Global Instant | Quickest setup, zero manual cloning | Node.js (>= 18) |
|
Plan B: Local Clone | Offline use, custom modification, auditing | Git + Node.js (>= 18) |
|
Configuration by Client
1. Antigravity IDE & CLI
Open MCP Servers in Antigravity → Manage MCP Servers → View raw config (mcp_config.json):
Plan A (Global via NPX):
{
"mcpServers": {
"denvora-groundwork": {
"command": "npx",
"args": ["-y", "denvora-groundwork"]
}
}
}Plan B (Local Clone):
{
"mcpServers": {
"denvora-groundwork": {
"command": "node",
"args": ["/path/to/denvora-groundwork-mcp/dist/index.js"]
}
}
}2. Claude Desktop & Claude Code
Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
Plan A (Global via NPX):
{
"mcpServers": {
"denvora-groundwork": {
"command": "npx",
"args": ["-y", "denvora-groundwork"]
}
}
}Plan B (Local Clone):
{
"mcpServers": {
"denvora-groundwork": {
"command": "node",
"args": ["/absolute/path/to/denvora-groundwork-mcp/dist/index.js"]
}
}
}3. Cursor & VS Code
In Cursor Settings → Features → MCP → Add New MCP Server:
Name:
denvora-groundworkType:
commandPlan A Command:
npx -y denvora-groundworkPlan B Command:
node /absolute/path/to/denvora-groundwork-mcp/dist/index.js
4. Kiro IDE
Add to .kiro/settings/mcp.json:
{
"mcpServers": {
"denvora-groundwork": {
"command": "npx",
"args": ["-y", "denvora-groundwork"]
}
}
}🤝 Synergy with denvora-ai-skills
Denvora Groundwork is designed as the native deterministic engine for denvora-ai-skills:
Skill: Governs how the AI interacts with you (bilingual empathy, mode router, brainstorming questions, and interactive approval).
Groundwork MCP: Provides the objective facts (AST export checking, CVE audits, PRD quality gate scoring, and unblocked task resolution).
Both can be used together for the ultimate Spec-Driven Development (SDD) experience, or standalone.
🧪 Development & Verification
# Clone the repository
git clone https://github.com/ardenpratamamaskuri404/denvora-groundwork-mcp.git
cd denvora-groundwork-mcp
# Install dependencies
npm install
# Compile strict TypeScript
npm run build
# Run unit tests (47 tests across 9 suites)
npm test
# Run end-to-end stdio JSON-RPC client check
node scratch/test_mcp_client.mjsPanduan Penggunaan & Instalasi (Bahasa Indonesia)
Selamat datang di Denvora Groundwork MCP! Server MCP ini dibuat khusus untuk memverifikasi kebenaran kode secara deterministik dan menyusun rencana spesifikasi teknis (Spec-Driven Development) sebelum AI mulai menulis kode program.
❓ Mengapa AI Coding Membutuhkan Denvora Groundwork?
Ketika berinteraksi dengan AI Coding Assistant (seperti Antigravity, Claude, Cursor, atau Kiro), sering kali AI:
Halusinasi Nama Fungsi/API: Menyebutkan fungsi atau method package yang sebenarnya tidak pernah ada di library npm.
Mengabaikan Versi: Menggunakan sintaks lawas atau parameter yang sudah di-deprecate.
Typosquatting: Menggunakan nama package yang mirip dengan aslinya (misalnya
axioalih-alihaxios).Langsung Ngoding Tanpa Rencana: Membuat kode acak-acakan tanpa arsitektur, batasan non-goals, atau tahapan kerja yang jelas.
Risiko Privasi: Berpotensi membaca atau memaparkan file rahasia seperti
.env, kredensial basis data, atau API key.
Denvora Groundwork MCP memecahkan masalah ini dengan menyediakan 10 alat deterministik yang berjalan langsung di komputer Anda melalui protokol standar stdio, tanpa biaya API key tambahan dan tanpa panggilan LLM eksternal.
🌟 Fitur Utama Denvora Groundwork
Modul Verifikasi (Verify):
AST Declaration Analysis: Mengunduh dan membaca file deklarasi
.d.tsdari npm secara statis menggunakan TypeScript Compiler API. Verdict yang dihasilkan selalu 3 nilai pasti:verified,not_found, atauunverifiable(bukan tebakan AI).Pencegahan Typosquatting: Memeriksa jarak Levenshtein terhadap library populer di npm untuk mencegah serangan malicious package.
Audit Kerentanan (CVE): Terhubung langsung ke basis data terbuka OSV (
api.osv.dev) untuk mendeteksi celah keamanan versi package.Saran Nama Symbol (
suggest_symbol): Memberikan rekomendasi nama export yang benar jika pengembang atau AI salah mengingat nama fungsi.
Modul Rencana (Plan):
Brainstorming Terarah: Menghasilkan maksimal 3 pertanyaan penjelas krusial dan kerangka prioritas (MoSCoW / Smallest Lovable v1).
Template Spesifikasi Bilingual: Kerangka siap pakai untuk PRD, Brief, Task, dan Workflow dalam Bahasa Indonesia atau Inggris.
Pintu Gerbang Kualitas Rencana (
plan_check): Mendeteksi rencana yang belum lengkap, menandai kata-kata ambigu (seperti "cepat", "mudah", "bagus" tanpa tolok ukur jelas), dan mencegah API key bocor.Pelacak Tugas Atomik (
plan_next_slice): Memilih tugas berikutnya yang belum terblokir berdasarkan dependensi dan kriteria verifikasi.
Perisai Privasi & Keamanan (Secret & Privacy Shield):
Blacklist File Rahasia: Menolak secara ketat setiap query atau pembacaan terhadap file
.env,.env.*,credentials.json,id_rsa, sertifikat.pem, dan folder~/.ssh/~/.aws.Sensor Otomatis (Redaction): Mengubah otomatis semua string API key (
sk-...,ghp_..., token bearer) menjadi teks aman[REDACTED_SECRET].Isolasi Sandbox & Tanpa Eksekusi: Tidak pernah menjalankan skrip instalasi npm atau
require()terhadap kode luar.
💻 Cara Pemasangan & Konfigurasi (Pilih Plan A atau Plan B)
Anda dapat memilih salah satu metode instalasi di bawah ini:
Metode | Cocok Untuk | Syarat | Cara Pakai |
Plan A: Global Instan (NPX) | Penggunaan langsung tanpa clone repositori | Node.js (>= 18) |
|
Plan B: Klon Lokal (Development) | Modifikasi kode, audit offline, berkontribusi | Git + Node.js (>= 18) |
|
1. Antigravity IDE & CLI
Buka berkas konfigurasi MCP (mcp_config.json) di Antigravity:
Plan A (Global via NPX):
{
"mcpServers": {
"denvora-groundwork": {
"command": "npx",
"args": ["-y", "denvora-groundwork"]
}
}
}Plan B (Klon Lokal):
{
"mcpServers": {
"denvora-groundwork": {
"command": "node",
"args": ["/path/to/denvora-groundwork-mcp/dist/index.js"]
}
}
}2. Claude Desktop & Claude Code
Edit file konfigurasi %APPDATA%\Claude\claude_desktop_config.json (Windows) atau ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
Plan A (Global via NPX):
{
"mcpServers": {
"denvora-groundwork": {
"command": "npx",
"args": ["-y", "denvora-groundwork"]
}
}
}Plan B (Klon Lokal):
{
"mcpServers": {
"denvora-groundwork": {
"command": "node",
"args": ["/absolute/path/to/denvora-groundwork-mcp/dist/index.js"]
}
}
}3. Cursor & VS Code
Masuk ke Cursor Settings → Features → MCP → Add New MCP Server:
Name:
denvora-groundworkType:
commandPerintah Plan A:
npx -y denvora-groundworkPerintah Plan B:
node /absolute/path/to/denvora-groundwork-mcp/dist/index.js
4. Kiro IDE
Tambahkan ke berkas .kiro/settings/mcp.json:
{
"mcpServers": {
"denvora-groundwork": {
"command": "npx",
"args": ["-y", "denvora-groundwork"]
}
}
}📋 Daftar 10 Alat Groundwork & Contoh Perintah
Nama Alat | Fungsi Singkat | Contoh Instruksi ke AI |
| Memeriksa eksistensi package npm dan jenis deklarasi TypeScript. | "Tolong periksa apakah package |
| Memverifikasi apakah method, function, atau class benar-benar di-export oleh library. | "Verifikasi apakah |
| Memberikan alternatif nama export yang tepat jika terjadi typo. | "Saya lupa nama fungsi di package |
| Memeriksa laporan CVE keamanan pada versi package tertentu. | "Cek apakah |
| Memeriksa package lokal di folder | "Periksa versi |
| Mengajukan pertanyaan kunci untuk memperjelas kebutuhan fitur baru. | "Saya ingin membuat fitur ekspor PDF, ajukan pertanyaan klarifikasi sebelum mulai merancang." |
| Menyediakan cetak biru dokumen teknis (PRD, Tasks, Architecture). | "Buatkan template PRD Blueprint untuk modul autentikasi pengguna." |
| Memvalidasi kelengkapan dokumen rencana dan mendeteksi ambiguitas. | "Tolong audit file |
| Menentukan langkah berikutnya yang belum terhambat dependensi. | "Baca daftar tugas di |
| Memeriksa status kesehatan server dan perisai privasi. | "Cek status koneksi Denvora Groundwork MCP." |
🤝 Sinergi dengan denvora-ai-skills
Denvora Groundwork bekerja secara selaras dengan repositori denvora-ai-skills:
denvora-ai-skills: Mengatur pola pikir, gaya komunikasi empatik bilingual, routing alur kerja, dan interaksi persetujuan dengan pengguna.denvora-groundwork-mcp: Menyediakan validasi teknis faktual (AST TypeScript nyata, skor lolos gate PRD, audit CVE, dan pemilihan task atomik).
📚 Core Principles
Deterministic Facts: Static AST declaration analysis without guessing or hallucinating APIs.
Spec-Driven Planning: Structured bilingual (ID / EN) templates for PRD, tasks, workflows, and briefs.
Strict Privacy Shield: Hardened boundary blocking credentials,
.env, and secret leakage.Zero API Keys & Zero External LLM Calls: 100% local, lightweight, and deterministic execution.
🤝 Contributing & Community
Contributions are welcome! Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a pull request or submitting issues.
📄 License
This project is open-source under the MIT License.
Copyright (c) 2026 Arden Pratama Maskuri.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Verify npm packages before your AI agent installs them: hallucinations, advisories, API drift.
Provide AI-powered real-time analysis and intelligence on NPM packages, including security, depend…
Checks AI-written code for leaked keys and made-up packages, on your machine. Never uploads code.
Package verdicts for AI coding agents: check npm, PyPI, Go and NuGet installs before they run.
Related MCP Servers
- AlicenseAqualityDmaintenanceActs as a security checkpoint for AI coding agents by intercepting package installations to verify existence, check against CVE databases, and block vulnerable or hallucinated dependencies before they reach your codebase. Provides seven security tools including pre-install gates, full project audits, safe version recommendations, and deep transitive dependency scanning for npm and PyPI packages.731 npm5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to automatically verify npm packages against the live registry before installation, flagging hallucinated, slopsquatted, or otherwise suspicious packages with risk verdicts.4 npmMIT
- AlicenseAqualityBmaintenanceEnables AI coding agents and CI to vet npm dependencies before they reach the lockfile, flagging hallucinated, slopsquatted, or otherwise risky packages with evidence-backed verdicts.352 npm4MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to verify, compare, and safely upgrade npm packages by scoring packages from public signals and sandboxed co-installation, detecting breaking API surface changes, and rewriting code that upgrades break.55 npm8MIT