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.5.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.5-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: depsentinel_guard-1.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 70a466a66f30b1748f287718b8ff59c7bd4e30f9a53a3ebae4ded11a6c7de1e1
MD5 1d85881454dbdcfe4aa6769064adeceb
BLAKE2b-256 30aeaa8f6de7193278b40b5c73e91ad9a667385f06645e28b96bac943bcce82d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for depsentinel_guard-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 ab17f62fbbf5585d3a6f7c042d7f03115c973f3d48a477af80a72b29695759ec
MD5 e1e44a65dfc641fd3531d21c0939c6e9
BLAKE2b-256 6982b4fcab0e37555756727628bba739f46d5f8b1fb006747462aca40d4fa55d

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

This release

1.1.5 This release

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

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