{
  "markdown": "# MITRE EMB3D\n\n[![Documentation build status](https://readthedocs.org/projects/mitre-emb3d/badge/?version=latest\n)](https://mitre-emb3d.readthedocs.io/en/latest/)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n\n\nA CLI, MCP Server, & AI based Threat Analysis for https://emb3d.mitre.org/\n\n## Run\n\n### Via `uvx`\n\n```bash\nuvx mitre-emb3d --help\nuvx mitre-emb3d --pprint properties Networking --level 3\n```\n\n## Add to your project\n\nThe project can be used both as a tool & library\n\n```bash\nuv add mitre-emb3d\n```\n\n\n## What this project enables!!\n\n### AI Driven Embedded Project Threat Analysis\n\n* Determine which device properties are applicable to your project\n* Do threat analysis\n* Generate a detailed project report and heatmap\n\n```bash\nuvx mitre-emb3d ai --repo <path-to-repo> --config config.toml map-properties\nuvx mitre-emb3d ai --repo <path-to-repo> --config config.toml threat-analysis\nuvx mitre-emb3d ai --repo <path-to-repo> --config config.toml gen-site\n```\n\nSee the documentation & guides for more information on configuration\nhttps://mitre-emb3d.readthedocs.io/en/latest/guides/\n\n### CLI & MCP Server\n\nYou can use the CLI or MCP server or both to build your own solutions\n\n* List device properties for a given category\n* List threats for a given category\n* List threats for a given device property\n* List device properties for a certain threat\n* List mitigations for a given threat\n* Get detailed information about a threat\n* Get detailed information about a mitigation\n* A CLI - AI Agent first (returns JSON output) / For humans add `--pprint` to see beautiful ouput\n* An MCP Server\n\nExample -\n\n```bash\n$ uvx mitre-emb3d --pprint list-threats-for-category \"Networking\"\n- TID-221: Authentication Bypass By Message Replay\n- TID-222: Critical System Service May Be Disabled\n- TID-310: Remotely Accessible Unauthenticated Services\n- TID-316: Incorrect Certificate Verification Allows Authentication Bypass\n- TID-317: Predictable Cryptographic Key\n- TID-318: Insecure Cryptographic Implementation\n- TID-401: Undocumented Protocol Features\n- TID-404: Remotely Triggerable Deadlock/DoS\n- TID-405: Network Stack Resource Exhaustion\n- TID-406: Unauthorized Messages or Connections\n- TID-407: Missing Message Replay Protection\n- TID-408: Unencrypted Sensitive Data Communication\n- TID-410: Cryptographic Protocol Side Channel\n- TID-411: Weak/Insecure Cryptographic Protocol\n- TID-412: Network Routing Capability Abuse\n```\n\n> Note --pprint (default is OFF, default output is JSON) for display\n\n\n***Explore other commands using the CLI help***\n\n```markdown\n\n Usage: mitre-emb3d [OPTIONS] COMMAND [ARGS]...\n\n╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n│ --version                                      Show the version of CLI and exit                                                                                              │\n│ --release                                TEXT  2.0.1, 2.0 ... [default: 2.0.1]                                                                                               │\n│ --loglevel            -l                 TEXT  Set the logging level (debug, info, warning, error, critical) [default: warning]                                              │\n│ --pprint                  --no-pprint          Whether to pretty-print the output (e.g. JSON lists) [default: no-pprint]                                                     │\n│ --install-completion                           Install completion for the current shell.                                                                                     │\n│ --show-completion                              Show completion for the current shell, to copy it or customize the installation.                                              │\n│ --help                                         Show this message and exit.                                                                                                   │\n╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n│ list-categories               List the categories                                                                                                                            │\n│ list-properties-for-category  List properties for a certain category                                                                                                         │\n│ list-properties-for-threat    List properties for a certain threat                                                                                                           │\n│ list-threats-for-category     List threats for a certain category                                                                                                            │\n│ list-threats-for-property     List threats for a certain device property                                                                                                     │\n│ list-mitigations              List mitigations for a certain threat                                                                                                          │\n│ threat                        Threat Information                                                                                                                             │\n│ mitigation                    Mitigation Information                                                                                                                         │\n│ mcp                           Launch the MCP server                                                                                                                          │\n│ ai                            AI related commands                                                                                                                            │\n╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n\n```\n\n## MCP Server\n\n> At the moment only STDIO is supported\n\nFor your `mcp.json` add the server like this\n\n```json\n{\n  \"servers\": {\n    \"mitre-emb3d\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mitre-emb3d\", \"mcp\"]\n    }\n  }\n}\n\n```\n\nUse mcp inspector to play with the MCP Server\n\n```bash\nnpx -y @modelcontextprotocol/inspector uvx mitre-emb3d mcp\n```\n",
  "bytes": 6764,
  "sha": "4152f7784154722c9f4c454b04cde34092e9f55a5d4689440a2c966a55351515",
  "repo_slug": "ksachdeva/mitre-emb3d",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_ksachdeva_mitre_emb3d_7439abc2/readme"
}