Skip to main content

CyberSafe MCP (v0.3 — Hybrid AI/ML Edition)

An open-source, plain-language Model Context Protocol (MCP) server built in Python to help everyday users—especially people 40+—stay safe on phones, laptops, and AI tools.

Built with the official Python MCP SDK v2 (mcp>=2.0.0).

What's Inside v0.3

Hybrid AI/ML + Regional Rules Scam Detection

  • analyze_scam_message(message, channel, region) now runs a Hybrid Engine:
    1. Explainable Regional Packs (global, india, us_uk) in src/cybersafe_mcp/scam_packs/*.json for clear, zero-jargon red flags (Digital Arrest, UPI QR fraud, KYC traps, IRS/HMRC scams, AI voice-cloning).
    2. Local HuggingFace AI Model (optional ml extra) that catches subtle or paraphrased scams with no exact keywords—running 100% locally in memory with zero user data sent to third-party AI APIs.

Other Security Tools

  • check_url_safety(url) — Local phishing heuristics + optional live URLhaus API lookups (never visits the link).
  • check_email_breach(email) — Live breach check via the free, no-key XposedOrNot API.
  • get_latest_alerts(limit, consumer_only, keyword) — Live consumer-filtered alerts from the CISA KEV Catalog.
  • check_password_hygiene(password_sample) — Pure local offline password-strength evaluator.
  • get_daily_cyber_tip(category) — One 60-second daily tip (phone, laptop, ai, general).

Quick Start

Lightweight Mode (Rules Only — Fastest Install)

uv sync --extra dev
uv run pytest
uv run mcp dev src/cybersafe_mcp/server.py

Full Hybrid AI/ML Mode (Rules + Local HuggingFace Model)

uv sync --extra dev --extra ml
uv run pytest
uv run mcp dev src/cybersafe_mcp/server.py

On the first call to analyze_scam_message, the ~17.6 MB BERT-Tiny model downloads once into your local HuggingFace cache and runs completely offline after that.

To swap models without changing code:

# macOS / Linux
CYBERSAFE_ML_MODEL=Horizon-Labs/phishing-scam-detector-base uv run mcp dev src/cybersafe_mcp/server.py

# Windows PowerShell
$env:CYBERSAFE_ML_MODEL="Horizon-Labs/phishing-scam-detector-base"
uv run mcp dev src/cybersafe_mcp/server.py

Remote Deployment (Streamable HTTP)

uv run cybersafe-mcp --transport streamable-http --host 0.0.0.0 --port 8000

Health endpoint: GET /health (also reports whether the AI/ML engine is enabled and which model is configured).

Metadata

Release files for cybersafe-mcp 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cybersafe-mcp 0.3.0
File Size Uploaded Provenance Actions
cybersafe_mcp-0.3.0.tar.gz 200.5 kB Without provenance Details for cybersafe_mcp-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cybersafe-mcp 0.3.0
File Interpreter ABI Platform Actions
cybersafe_mcp-0.3.0-py3-none-any.whl Python 3 none any Details for cybersafe_mcp-0.3.0-py3-none-any.whl

Total release size: 229.4 kB

Release files / cybersafe_mcp-0.3.0.tar.gz

Download URL cybersafe_mcp-0.3.0.tar.gz
Size 200.5 kB
Tags Source
SHA-256 checksum
How to use checksums
861924225f27a2f7b32fa882e89734fad072fa2b3b64a254e588e5a033efc54e
BLAKE2b-256 checksum
How to use checksums
b2458b2714108842a390b5ee6db7c133dc3680b96a30f8926fd69d6ffe69c822
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / cybersafe_mcp-0.3.0-py3-none-any.whl

Download URL cybersafe_mcp-0.3.0-py3-none-any.whl
Size 28.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1688d10651c07ac345c3dbcaf0867cf3a8763b26856d332142d756be8d96364e
BLAKE2b-256 checksum
How to use checksums
ccf31194c93093a25e0e19e9692f9dc41ce4b716debca42ee533bbed3eac84a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for cybersafe-mcp 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page