TridentChain Security

TridentChain Security

本地优先的漏洞扫描器，可扫描项目依赖项、开发者工具和 IDE 扩展。
使用多源情报（OSV、NVD、GHSA、Sonatype），并根据 KEV/EPSS 进行优先级排序。

默认使用无需 API 密钥。

公共仓库：https://github.com/DevInder1/supply-chain-scanner-public

---

安装（开箱即用）

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

Agent 和 MCP（Claude、Cursor、VS Code、Windsurf、Zed）：

选择最适合你的安装方式：

# 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"]

你可以做什么：docs/CAPABILITIES.md
完整指南：docs/INSTALL_AND_USE.md
跨平台（macOS / Linux / Windows）：docs/CROSS_PLATFORM.md
（PyPI：tridentchain-security · npm：@tridentchain/security-cli）

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

---

在你自己的 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"])

---

扫描配置

配置	说明
full（默认）	项目 + 系统 + 扩展。无需密钥即可使用 OSV + NVD。
quick	更快、侧重项目的扫描。
offline	仅使用本地公告数据库，不联网。
高级用户	添加 GITHUB_TOKEN、NVD_API_KEY，以及可选的 SONATYPE_TOKEN，以获得最佳覆盖率。

---

桌面应用（独立应用程序）

如果已安装 pip 软件包，则无需克隆仓库：

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

请参阅 apps/desktop/README.md 和 docs/DISTRIBUTION_VERIFICATION.md。

AI / 自动化（Claude、OpenAI、Cursor、VS Code、Windsurf 等）

一次安装，适用于所有 Agent： pip install "tridentchain-security>=0.1.2" tridentchain-mcp

指南	说明
Agent 集成	Claude · OpenAI · Cursor · VS Code · Windsurf · Zed · MCP · CLI
功能	当前可用的全部功能
架构	MCP + 统一工具设计

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

第 2 阶段 — Claude MCP： pip install tridentchain-mcp · 设置指南 · 插件

第 3 阶段 — OpenAI + Cursor： examples/openai/ · Cursor 设置 · .cursor/mcp.json.example

第 4 阶段 — VS Code（Anthropic MCP）： 打开仓库 → MCP 就绪 · VS Code 设置 · ./scripts/vscode-mcp-install-link.sh · 扩展

第 5 阶段 — 验证： tridentchain-security --validate · MCP validate_after_patch · CAPABILITIES.md

统一工具层：from scanner.integrations import execute_tool, get_tool_definitions, to_openai_tools

---

开发

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

安装与使用：docs/INSTALL_AND_USE.md
跨平台：docs/CROSS_PLATFORM.md
CLI 合约：docs/cli-contract.md
发布：docs/PUBLISHING.md

---

可选 API 密钥（高级用户）

变量	用途
NVD_API_KEY	提高 NVD 速率限制
GITHUB_TOKEN	GHSA 公告
SONATYPE_TOKEN	Sonatype Guide 公告

在 .env 或环境变量中设置。

---

许可证

MIT — 参见 LICENSE