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

Uploaded Python 3

File details

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

File metadata

  • Download URL: depsentinel_guard-1.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 3df7d67d0b9ea9d1fbe7b773021b53c60d5c6d4892419b854a958f45a922d5a0
MD5 008c4ad80d8b46ac9cad2251cd6a8a6b
BLAKE2b-256 457f17697146da91370cd0a8444e03f8bfdaa7a8488bf3c8158511023f06169a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for depsentinel_guard-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5017c115b8b4714bc4d1fcee810ab4b73c2964ba7ce2e42c36ca4e14f7a34814
MD5 da801b954d395af7f4dacd48cc534ce5
BLAKE2b-256 be34fd0c646f1573f95a73912a56bcb2237d4019758cb21cf14d4a03770fce28

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

This release

1.1.3 This release

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