supply-chain-scanner-public

# TridentChain Security

[![PyPI — tridentchain-security](https://img.shields.io/pypi/v/tridentchain-security?label=tridentchain-security&color=3b82f6)](https://pypi.org/project/tridentchain-security/)
[![PyPI — tridentchain-mcp](https://img.shields.io/pypi/v/tridentchain-mcp?label=tridentchain-mcp&color=3b82f6)](https://pypi.org/project/tridentchain-mcp/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/tridentchain-mcp?label=downloads&color=34d399)](https://pypi.org/project/tridentchain-mcp/)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-active-34d399)](https://registry.modelcontextprotocol.io/v0.1/servers?search=tridentchain)
[![Python](https://img.shields.io/badge/python-3.10%2B-3776ab?logo=python&logoColor=white)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
[![Works with Claude · Cursor · VS Code · Windsurf · Zed](https://img.shields.io/badge/Claude%20%C2%B7%20Cursor%20%C2%B7%20VS%20Code%20%C2%B7%20Windsurf%20%C2%B7%20Zed-MCP-7c3aed)](docs/AGENT_INTEGRATIONS.md)
[![Docker (ghcr.io)](https://img.shields.io/badge/ghcr.io-tridentchain--mcp-2496ed?logo=docker&logoColor=white)](https://github.com/DevInder1/supply-chain-scanner-public/pkgs/container/tridentchain-mcp)

Local-first vulnerability scanner for project dependencies, developer tools, and IDE extensions.  
Uses multi-source intelligence (OSV, NVD, GHSA, Sonatype) with KEV/EPSS prioritization.

**No API key required** for default usage.

Public repo: https://github.com/DevInder1/supply-chain-scanner-public

---

## Install (plug and play)

```bash
pip3 install tridentchain-security
npm install -g @tridentchain/security-cli
tridentchain-security --help
```

**Agents & MCP (Claude, Cursor, VS Code, Windsurf, Zed):**

Pick whichever install path fits:

```bash
# Option A — pip (needs Python 3.10+)
pip3 install -U "tridentchain-security>=0.1.4" "tridentchain-mcp>=0.1.4"

# Option B — uvx (no manual Python install; uv handles it)
uvx tridentchain-mcp

# Option C — Docker (no Python needed, fully sandboxed)
docker pull ghcr.io/devinder1/tridentchain-mcp:latest
# Then in your MCP config, replace `python3 -m tridentchain_mcp` with:
#   command: docker
#   args: ["run", "--rm", "-i", "-v", "$PWD:/workspace", "ghcr.io/devinder1/tridentchain-mcp:latest"]
```

What you can do: **[docs/CAPABILITIES.md](docs/CAPABILITIES.md)**  
Full guide: **[docs/INSTALL_AND_USE.md](docs/INSTALL_AND_USE.md)**  
Cross-platform (macOS / Linux / Windows): **[docs/CROSS_PLATFORM.md](docs/CROSS_PLATFORM.md)**  
(PyPI: [tridentchain-security](https://pypi.org/project/tridentchain-security/) · npm: [@tridentchain/security-cli](https://www.npmjs.com/package/@tridentchain/security-cli))

```bash
tridentchain-security --scan all --project-path . --output-dir scanner-output
```

---

## Use in your own Python app

```python
from scanner import run_scan

summary = run_scan(
    project_path=".",
    scan="all",
    run_profile="full",  # no API key required
    output_dir="scanner-output",
)
print(summary["summary"])
```

---

## Scan profiles

| Profile | Description |
|---------|-------------|
| `full` (default) | Project + system + extensions. OSV + NVD without keys. |
| `quick` | Faster project-focused scan. |
| `offline` | Local advisory DB only, no network. |
| Power-user | Add `GITHUB_TOKEN`, `NVD_API_KEY`, optional `SONATYPE_TOKEN` for best coverage. |

---

## Desktop app (individual application)

No repo clone required if the pip package is installed:

```bash
pip3 install tridentchain-security
cd apps/desktop && npm install && npm run start
```

See [apps/desktop/README.md](apps/desktop/README.md) and [docs/DISTRIBUTION_VERIFICATION.md](docs/DISTRIBUTION_VERIFICATION.md).

## AI / automation (Claude, OpenAI, Cursor, VS Code, Windsurf, …)

**One install, every agent:** `pip install "tridentchain-security>=0.1.2" tridentchain-mcp`

| Guide | Description |
|-------|-------------|
| **[Agent integrations](docs/AGENT_INTEGRATIONS.md)** | Claude · OpenAI · Cursor · VS Code · Windsurf · Zed · MCP · CLI |
| [Capabilities](docs/CAPABILITIES.md) | Everything you can do today |
| [Architecture](docs/INTEGRATION_ARCHITECTURE.md) | MCP + unified tools design |

```bash
./scripts/setup-agent-mcp.sh cursor   # prints setup for your agent
```

**Phase 2 — Claude MCP:** `pip install tridentchain-mcp` · [Setup guide](docs/CLAUDE_MCP_SETUP.md) · [Plugin](plugins/tridentchain-security/)

**Phase 3 — OpenAI + Cursor:** [examples/openai/](examples/openai/) · [Cursor setup](docs/CURSOR_SETUP.md) · `.cursor/mcp.json.example`

**Phase 4 — VS Code (Anthropic MCP):** Open repo → MCP ready · [VS Code setup](docs/VSCODE_SETUP.md) · `./scripts/vscode-mcp-install-link.sh` · [extension](extensions/vscode-tridentchain/)

**Phase 5 — Validate:** `tridentchain-security --validate` · MCP `validate_after_patch` · [CAPABILITIES.md](docs/CAPABILITIES.md)

Unified tool layer: `from scanner.integrations import execute_tool, get_tool_definitions, to_openai_tools`

---

## Development

```bash
git clone https://github.com/DevInder1/supply-chain-scanner-public.git
cd supply-chain-scanner-public
python3 -m pip install -e .
tridentchain-security --help
python3 -m unittest scanner.tests.test_matcher_ranges -v
```

Install & use: `docs/INSTALL_AND_USE.md`  
Cross-platform: `docs/CROSS_PLATFORM.md`  
CLI contract: `docs/cli-contract.md`  
Publishing: `docs/PUBLISHING.md`

---

## Optional API keys (power users)

| Variable | Purpose |
|----------|---------|
| `NVD_API_KEY` | Higher NVD rate limits |
| `GITHUB_TOKEN` | GHSA advisories |
| `SONATYPE_TOKEN` | Sonatype Guide advisories |

Set in `.env` or environment variables.

---

## License

MIT — see [LICENSE](LICENSE)