
ThreatLocker
io.github.WYRE-AI由 GitHub 帳號 WYRE-AI 發布v1.4.2更新於 Nov 21, 2026
MCP server for ThreatLocker — zero-trust endpoint protection, allowlisting, and policies.
概覽
將助理連接到 ThreatLocker 入口網站 API,用來檢視電腦、核准請求、稽核記錄與組織,服務於零信任端點防護。
- 可以做什麼
- 導覽各功能領域並檢查 API 連線狀態
- 列出並檢視電腦詳細資料、簽入歷程與電腦群組
- 列出、檢視並統計核准請求,包含許可申請詳細資料
- 搜尋稽核記錄項目、取得單筆記錄並查看檔案的稽核歷程
- 列出子組織、取得組織的安裝授權金鑰,以及列出可用於移動電腦的組織
- 適用情境
- 適合已在使用 ThreatLocker 的資安或 IT 管理員,希望以自然語言查詢端點清冊、待處理核准與稽核歷程,而不必在入口網站中逐項點選。
- 執行需求
- 以 stdio 方式在本機執行(Docker 映像或從原始碼建置的 Node.js 版本)。需要 ThreatLocker API 金鑰(THREATLOCKER_API_KEY)與組織 ID(THREATLOCKER_ORGANIZATION_ID),並能連線至 ThreatLocker API。閘道/HTTP 模式另需 AUTH_MODE=gateway 與 CONDUIT_S2S_SECRET,並透過請求標頭逐次提供憑證。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 ThreatLocker,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
ThreatLocker MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to the ThreatLocker Portal API. Manage computers, approval requests, audit logs, and organizations through natural language interactions.
Features
- Stateless Architecture: No session state required, fresh connections per request
- Decision-Tree Navigation: Navigate domains with
threatlocker_navigate - Gateway Mode: Multi-tenant support via HTTP headers
- Elicitation Support: Interactive prompts for missing parameters
- Comprehensive Error Handling: Detailed error messages and logging
- Docker Support: Production-ready containerization
Tools
Navigation
threatlocker_navigate- Navigate to a domain to see available toolsthreatlocker_status- Check API connection status and available domains
Computers
threatlocker_computers_list- List computers with filters (search, group, pagination)threatlocker_computers_get- Get detailed computer informationthreatlocker_computers_get_checkins- Get computer checkin history
Computer Groups
threatlocker_computer_groups_list- List computer groups with filtersthreatlocker_computer_groups_dropdown- Get computer groups for dropdown selection
Approval Requests
threatlocker_approvals_list- List approval requests with status filtersthreatlocker_approvals_get- Get detailed approval request informationthreatlocker_approvals_pending_count- Get count of pending approvalsthreatlocker_approvals_get_permit_application- Get permit application details
Troubleshooting: if approval tools return an HTTP 401 / "Authentication failed" while audit tools work with the same key, the ThreatLocker API user/role lacks Approval Center permissions. An admin must grant them in the ThreatLocker portal; retrying will not help.
Audit Log
threatlocker_audit_search- Search audit log entries with filters.searchTextis a path filter (ThreatLockerfullPath), not free text: it matches the file path and also each row's process path and created-by path, so a program's path also finds what that program did. Give a full path or use*wildcards (*\setup.msi). Filter by computer withhostname. PasschildOrganizations: truefor computers in child organizations. Filter by result withactionId(1 Permit, 2 Deny, 3 Deny with option to request, 6 Ringfenced, 99 Any Deny;onlyTrueDenies/simulateDenysplit enforced from monitor-only denies) and byactionType(execute, install, network, ...).groupByscounts rows by one or two fields, soactionId: 2, groupBys: [6, 9]breaks denies down by policy name and action type. These filters need the SDK release that adds them; older SDKs send onlyactionTypethreatlocker_audit_get- Get one audit log entry; passeActionLogId,sourceTableIdandorganizationIdstraight from thethreatlocker_audit_searchrow (organizationIdis required for rows from child organizations; deprecated alias:actionLogId). HTTP 500 is reported as an actionable error: re-search and pass all three fields from the same rowthreatlocker_audit_file_history- Get audit history for a file. RequiresfullPathand eitherhostnameorcomputerId. For a computer in a child organization also passorganizationId(from itsthreatlocker_computers_listrow); without it the result is empty. Needs@wyre-ai/node-threatlockerwithgetFileHistory({ organizationId })support
Organizations
threatlocker_organizations_list_children- List child organizationsthreatlocker_organizations_get_auth_key- Get the installation auth key for the organization the configured credentials are scoped to. The result is a sensitive key and is never logged. Reports an explicit error instead of{}when ThreatLocker returns no JSON key, and returns text bodies with SDK 3.0.2threatlocker_organizations_for_move_computers- Get organizations for computer moves
Configuration
Environment Variables
Stdio Mode (Direct API Access)
Gateway Mode (Multi-tenant)
CONDUIT_S2S_SECRET is required for the HTTP transport. The process logs an error and exits non-zero when it is unset. For local development only, MCP_ALLOW_INSECURE_DEV=1 starts the server anyway and logs a loud warning; do not set that flag in production. The secret is never written to the logs.
When MCP_HTTP_HOST is unset, the server binds 127.0.0.1. The Dockerfile sets MCP_HTTP_HOST=0.0.0.0 so the process listens inside the container; publish that port on localhost.
Gateway Mode Headers
When running in gateway mode, include these headers with each request:
X-Gateway-S2S: Service-to-service proof from the gateway (t=<unix>,v1=<hmac>). Requests without a valid header are rejected with 401 whenCONDUIT_S2S_SECRETis set.X-Threatlocker-Api-Key: Your ThreatLocker API key (required). A request without it is rejected with 401 and does not fall back toTHREATLOCKER_API_KEY.X-Threatlocker-Organization-Id: Your organization ID (optional; the API defaults to the key's primary organization)
/health and /healthz stay unauthenticated and do not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.
Logging
Local Development
- Clone the repository:
- Install dependencies:
- Set environment variables:
- Build and run:
- Test the server:
Docker
Using Docker Compose
Using Docker directly
Architecture
Directory Structure
Design Patterns
- Domain Handlers: Each API area has its own handler with
getTools()andhandleCall() - Lazy Loading: Domain handlers are imported on-demand
- Fresh Connections: New server instance per HTTP request for stateless operation
- Credential Invalidation: Client is reset when credentials change
- Elicitation Framework: Interactive prompts for missing parameters
License
Apache-2.0 - see LICENSE for details.
來源:README.md,提交 af389e2
工具
0版本歷史
8- v1.4.2最新Nov 21, 2026
- v1.4.1Nov 14, 2026
- v1.4.0Nov 12, 2026
- v1.3.14Nov 11, 2026
- v1.3.12Oct 10, 2026
- v1.3.11Oct 9, 2026
- v1.3.10Sep 24, 2026
- v1.3.9Sep 16, 2026
評分
已滿足適用檢查項的 40%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
請在儲存庫或註冊中心條目中宣告授權條款。