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:- Explainable Regional Packs (
global,india,us_uk) insrc/cybersafe_mcp/scam_packs/*.jsonfor clear, zero-jargon red flags (Digital Arrest, UPI QR fraud, KYC traps, IRS/HMRC scams, AI voice-cloning). - Local HuggingFace AI Model (optional
mlextra) 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.
- Default model:
mrm8488/bert-tiny-finetuned-sms-spam-detection(~17.6 MB, fast on CPU). - Multilingual alternative: set
CYBERSAFE_ML_MODEL=Horizon-Labs/phishing-scam-detector-base(model card).
- Explainable Regional Packs (
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.