tcpk

mcp
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 19 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Portable Windows toolkit for pentesting thick-client applications, including .NET, MSIX, and native binaries.

README.md
TCPK

TCPK -- Thick Client Pentest Kit

Portable Windows thick-client / MSIX security audit tool.
Find. Verify. Report.

PowerShell engine, WinForms GUI, an agentic AI workbench (loopback browser UI), and a native MCP server.
Authorized testing only.


The tool

TCPK GUI

Point it at an MSIX package, an installed folder, or a single .exe, click Run Audit, and
TCPK runs 260 cmdlets across 19 buckets (174 of them detection checks), streams findings live, and writes HTML + Excel
reports. Every finding carries a confidence label, a computed CVSS v4.0 base score, CWE,
MITRE ATT&CK, and an OWASP TASVS mapping. The same engine drives the CLI, a native MCP
server
, and an agentic AI workbench (TCPK-Agentic.bat -- loopback, token-gated,
discovery-only) with decompile, local AI review, and an autonomous agent.

TCPK agentic AI workbench

What makes it different

  • Evidence over guessing. Regex hits are Inferred; a Mono.Cecil IL bridge then proves
    the high-value ones (e.g. an accept-all TLS callback decompiled and proven to return true)
    and promotes them to Confirmed (IL) via a bounded source-to-sink taint check -- deterministic,
    no model.
  • Real CVSS v4.0. A faithful port of the FIRST.org algorithm scores each finding from its own
    vector, so a local issue is never mislabelled as network-reachable.
  • Supply-chain CVEs. Shipped components matched against live OSV (NuGet/npm/Maven) + NVD-by-CPE
    (native libs), version-accurate, embedded in a CycloneDX SBOM. Online-only, fails closed.
  • Local-first AI triage (optional). -EnableLlm pipes findings through a local Ollama model;
    cloud is gated behind an explicit opt-in (decompiled IL never leaves the box by default).
  • Engagement-ready reports. HTML (confidence-segregated) + multi-sheet Excel with a 55-case
    Checklist, DLL Hardening + Signing matrices, plus JSON, SARIF, a CycloneDX SBOM, and a
    self-contained intel.html dashboard.
  • Live-process tooling. A Runtime/Live tab of read-only process checks and a Process Monitor
    (live watch + activity capture), plus a Hex view with a data inspector, strings, and byte
    colouring -- in both the desktop GUI and the agentic workbench.
  • Honest about scope. It automates detection; dynamic confirmation (Burp, mimikatz,
    modify-and-relaunch) stays manual -- and the tool says so.

Coverage

A Static binary - B MSIX manifest - C OS integration - D Credentials - E Runtime/live -
F Network - G WebView2 - H Logging - I Memory - J Anti-debug - K Exploit (gated) --
plus Recon / Report.

Full check catalogue in docs/CHECKS.md; the 55-case thick-client test plan is
auto-correlated in the Excel Checklist sheet (53 of 55 automated). Full technical write-up in
docs/index.html (published as a free GitHub Pages site).

Supported targets

Path-based: MSIX / AppX / .msixbundle / .zip, an installed or extracted folder, or a single
portable .exe -- MSIX, MSI, ClickOnce, Squirrel, and portable apps alike (manifest checks
auto-skip when absent). For thin clients it audits the client-side binaries; the remote API is a
separate engagement.

Quick start

GUI: double-click TCPK.bat (keep the whole folder together), accept the authorized-use
prompt, pick a target, click Run Audit.

PowerShell:

Import-Module .\TCPK\TCPK.psd1 -Force
Invoke-TcpkAudit -Target 'C:\Path\To\App' -Acknowledge              # static + OS + network ...
Invoke-TcpkAudit -Target 'C:\Path\To\App' -Acknowledge -EnableLlm   # + local AI triage

Reports land in .\out\<target>_<date>\: index.html, report.xlsx, findings.json,
sbom.cdx.json, report.sarif, intel.html.

Requirements

Windows 10/11, PowerShell 5.1 or 7+. Admin only for some deep runtime checks. Optional local AI
needs Ollama + a pulled model (e.g. qwen2.5-coder:7b).
Optional tools per tab (Wireshark for pcap, mitmproxy for intercept, frida for runtime
hooks) install separately: see docs/INSTALL.md. The static audit needs none of them.

Resources

Acknowledgements

Srinivas (DVTA) - Damn Vulnerable Thick Client Application.

Authorized use only

For security testing of software you own or are explicitly authorized to test. Provided AS IS,
no warranty. See DISCLAIMER.txt. TCPK is MIT licensed; redistributed third-party components and
their licences are listed in NOTICE.


TCPK v2.9.0 - see README.txt for the full manual and docs/ for methodology.

Reviews (0)

No results found