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

Uploaded Python 3

File details

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

File metadata

  • Download URL: depsentinel_guard-1.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 89d2896d189825fc5283ec4de397df2b1158129c5c9f0b2ba9b7542a9b114a5b
MD5 d3fd2b1f0026d129e3b2488c7adc4146
BLAKE2b-256 0c3bb59aca690bb3b6c0150de1c6f6263f27fc988087244c9677614503c73e9f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for depsentinel_guard-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5e5c3f0e636002a8df2bcd867aaa66139ea1043a72000c0fcca49cfa42d91b25
MD5 3584ad18f71f2f8240579f6cfb638c1e
BLAKE2b-256 b86eaa2ca5e945bc4af771c1e5d0fc069e44e5b25fbbeb1af6024e2c3a9082bf

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

1.1.1

2 files

This release

1.1.0 This release

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