Skip to main content

🛡️ DepSentinel MCP Server

PyPI License: MIT

DepSentinel is an AI Package Hallucination & Supply-Chain Attack Guard. This official Model Context Protocol (MCP) server allows any AI IDE or coding assistant (Cursor, Claude Desktop, Antigravity, VS Code, Windsurf, etc.) to automatically verify npm packages across 7 security layers before installation.


⚡ How It Works

Before running npm install, your AI assistant automatically invokes verify_packages over MCP. The engine streams 7 independent analysis layers:

  1. 🔍 Layer 0 · Registry Existence: Instant check against live npm registry to catch hallucinated package names.
  2. 🎯 Layer 1 · Semantic Intent Matching: Cosine similarity matching between developer's stated goal and package capabilities.
  3. 🔬 Layer 2 · Heuristics: Typosquatting edit distance, download metrics, package age, and install-hook traps.
  4. 🛡️ Layer 3 · Vulnerability Advisories: Real-time OSV.dev and CVE tracking for unpatched vulnerabilities.
  5. 📝 Layer 5 · Static Code Analysis: Deep AST parsing of source files for command execution (child_process), network calls, and token access.
  6. 🤖 Layer 6 · AI Deep Code Scan: Autonomous LLM review of full package source code.
  7. 💥 Layer 7 · Detonation Sandbox: Full runtime sandbox execution with active syscall interception to prevent execution of backdoors.

🚀 Quick Setup

Get your API key at DepSentinel Platform.

1. Cursor IDE

Add to your Cursor Settings > Features > MCP Servers or in .cursor/mcp.json:

{
  "mcpServers": {
    "depsentinel": {
      "command": "uvx",
      "args": ["depsentinel-guard"],
      "env": {
        "DEPSENTINEL_API_KEY": "ds_your_api_key_here",
        "DEPSENTINEL_API_URL": "https://depsentinel.neuraliftx.in"
      }
    }
  }
}

2. Claude Desktop

Add to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "depsentinel": {
      "command": "uvx",
      "args": ["depsentinel-guard"],
      "env": {
        "DEPSENTINEL_API_KEY": "ds_your_api_key_here",
        "DEPSENTINEL_API_URL": "https://depsentinel.neuraliftx.in"
      }
    }
  }
}

3. Antigravity IDE / Gemini

Add to ~/.gemini/antigravity-ide/mcp_config.json or ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "DepSentinel": {
      "command": "uvx",
      "args": ["depsentinel-guard"],
      "env": {
        "DEPSENTINEL_API_KEY": "ds_your_api_key_here",
        "DEPSENTINEL_API_URL": "https://depsentinel.neuraliftx.in"
      }
    }
  }
}

4. Windsurf IDE

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "depsentinel": {
      "command": "uvx",
      "args": ["depsentinel-guard"],
      "env": {
        "DEPSENTINEL_API_KEY": "ds_your_api_key_here",
        "DEPSENTINEL_API_URL": "https://depsentinel.neuraliftx.in"
      }
    }
  }
}

5. VS Code (Cline / Roo Code / Continue)

In your extension's MCP configuration settings:

{
  "mcpServers": {
    "depsentinel": {
      "command": "uvx",
      "args": ["depsentinel-mcp"],
      "env": {
        "DEPSENTINEL_API_KEY": "ds_your_api_key_here",
        "DEPSENTINEL_API_URL": "https://depsentinel.neuraliftx.in"
      }
    }
  }
}

(Note: If uvx is not installed on your system, install it via pip install uv or use python -m depsentinel_mcp after running pip install depsentinel-mcp).


🛠️ MCP Tools Exposed

Tool Description
verify_packages(intent, packages) Verifies one or more npm package names or local .zip/.tgz file paths against 7 security layers with live streaming.
quick_check(package_name) Fast single-package existence and health check.

📄 License

MIT License. Developed with ❤️ by the DepSentinel Security Team.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

depsentinel_guard-1.1.1.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

depsentinel_guard-1.1.1-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file depsentinel_guard-1.1.1.tar.gz.

File metadata

  • Download URL: depsentinel_guard-1.1.1.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.2

File hashes

Hashes for depsentinel_guard-1.1.1.tar.gz
Algorithm Hash digest
SHA256 41799e20d6c8ee19370b1fc34cb21b6e1e42c673c49dd96816a8d64c008d59b0
MD5 83196bd1ed2ed8d67e131c5f5fd28b59
BLAKE2b-256 2eca32f41ae7241be42e9017f459664c4c4d0f3b88b401e796286f6e8bdef572

See more details on using hashes here.

File details

Details for the file depsentinel_guard-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for depsentinel_guard-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d99a595ba9cd7593e4f9bf8617eaf7c6e88bfedfce34ec85fcb5df6a06d14c8a
MD5 d719b03639c853d8a3f25da3a6a2fd59
BLAKE2b-256 5a74a2f07e9dcd5a80774eb0c46726346b667838bb12134fdcce256255df71ed

See more details on using hashes here.

Release history Release notifications | RSS feed

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.9

2 files

1.2.8

2 files

1.2.7

2 files

1.2.6

2 files

1.2.5

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.6

2 files

1.1.5

2 files

1.1.3

2 files

1.1.2

2 files

This release

1.1.1 This release

2 files

1.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page