TridentChain Security

TridentChain Security

プロジェクトの依存関係、開発者ツール、IDE 拡張機能をスキャンする、ローカル優先の脆弱性スキャナーです。
KEV／EPSS による優先順位付けを備えた、複数の情報源（OSV、NVD、GHSA、Sonatype）のインテリジェンスを使用します。

標準の使用では、API キーは不要です。

公開リポジトリ：https://github.com/DevInder1/supply-chain-scanner-public

---

インストール（すぐに使えます）

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

エージェントと 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 など）

一度のインストールですべてのエージェントに対応： pip install "tridentchain-security>=0.1.2" tridentchain-mcp

ガイド	説明
エージェント連携	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 を参照