Mitre Attack Mcp Server

io.github.imouiche由 GitHub 帳號 imouiche 發布v0.1.6更新於 Nov 14, 2026

MCP server providing 50+ tools for MITRE ATT&CK techniques, groups, and mitigations

已驗證STDIO僅桌面知識與記憶安全與監控

概覽

AI 產生的概覽

本機 MCP 伺服器,讓助理以唯讀方式查詢 MITRE ATT&CK 知識庫中的技術、組織、軟體、行動與緩解措施。

可以做什麼
  • 依 ID、關鍵字、平台或戰術查找與搜尋技術、戰術、子技術與已撤銷技術
  • 檢視威脅組織及其別名、使用的技術與軟體,以及行動歸因
  • 查詢惡意程式與工具、行動、緩解措施、資料來源與資料元件,以及 ICS 資產
  • 追蹤關聯,例如哪些組織使用某項技術、什麼能緩解什麼,以及程序範例
  • 依 STIX 或 ATT&CK ID 存取任意 STIX 物件,支援建立/修改時間篩選與 ID 轉名稱
  • 產生 ATT&CK Navigator 圖層,並回報資料狀態、實體數量與矩陣
適用情境
適合威脅情報研究、偵測覆蓋與缺口對照、描繪威脅行為者的 TTP,或回答關於 Enterprise、Mobile 與 ICS 領域 ATT&CK 技術與緩解措施的問題。
執行需求
以 stdio 在本機執行。PATH 中需有 Python 3.12 或更新版本;僅 npm 安裝方式需要 Node.js 16 或更新版本。首次執行會下載約 64MB 的 ATT&CK STIX 資料,並在家目錄下的私有虛擬環境安裝相依套件(約 290MB 磁碟、約 490MB 記憶體)。可選環境變數 MITRE_MCP_PYTHON、MITRE_MCP_RUNTIME_DIR 與 MITRE_MCP_DATA_DIR 可變更解譯器與快取位置。
安裝前請注意
首次啟動可能因下載相依套件與資料而耗時數分鐘,可能超過用戶端啟動逾時;建議先以安裝指令預熱快取。資料快取不會自動失效,舊版本目錄會持續累積佔用磁碟。所有工具皆為唯讀查詢,不需要任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mitre Attack Mcp Server,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MITRE ATT&CK MCP Server

65 MCP tools giving LLMs and agentic systems machine-callable access to the MITRE ATT&CK knowledge base

[MCP tools] [Domains] [ATT&CK] [npm] [npm downloads] [License] [MCP Registry] [MCPRush security rating]

Installation · Quick Start · Security · Data Cache · Tools · Examples


Overview

The MITRE ATT&CK MCP Server exposes the MITRE ATT&CK framework over the Model Context Protocol, giving LLMs and agentic systems structured, machine-callable access to adversary tactics, techniques, threat groups, software, campaigns and mitigations.

It reads the official STIX 2.1 bundles published by MITRE through the mitreattack-python library. No scraping, no third-party API, no reverse-engineered endpoints.

65 tools across three domains

AreaToolsCovers
Tactics, data sources and ICS12tactics, data components and what they detect, ICS assets, procedure examples
Techniques11lookup by ATT&CK ID, keyword search, parent and sub-technique traversal, platform and tactic filters
Generic STIX access10any object by STIX or ATT&CK ID, description search, created and modified filters, ID to name resolution
Groups10threat actors, aliases, the techniques and software they use, campaign attribution
Software8malware and tools, aliases, the techniques they implement, who deploys them
Campaigns6campaigns, aliases, their techniques and software, attribution to groups
Infrastructure and metadata5data status, entity counts, matrices, Navigator layer generation
Mitigations3mitigations and the techniques they address

Covering Enterprise, Mobile and ICS, with relationship traversal throughout — which groups use a technique, which software a campaign deployed, what mitigates what — plus ATT&CK Navigator layer generation for coverage and gap visualisation. All output is shaped for LLM consumption.

Registered in the official MCP Registry as io.github.imouiche/mitre-attack-mcp-server.


Installation

Python (PyPI)

bash
pip install mitre-mcp-server

Or with uv:

bash
uv pip install mitre-mcp-server

Node (npm)

bash
npm install -g @imouiche/mitre-attack-mcp-server

Or without installing:

bash
npx -y @imouiche/mitre-attack-mcp-server

The npm package needs a few minutes on first run. It ships the Python source, not the Python dependencies. On first launch it creates a private virtualenv under ~/.mitre-mcp-server/runtime/, installs the pinned dependencies into it, and downloads the ATT&CK STIX data. Subsequent runs start in a few seconds.

Some MCP clients time out waiting for a server to respond, so warm the cache once from a terminal before configuring your client:

bash
npx -y @imouiche/mitre-attack-mcp-server --setup

Python 3.12 or newer must be on PATH. uv is used when available and venv plus pip otherwise. Nothing is installed into your system or currently active Python environment.

Environment variables
VariableEffect
MITRE_MCP_PYTHONUse this interpreter directly and skip virtualenv creation entirely. It must already satisfy the dependencies in pyproject.toml, including mcp<2.
MITRE_MCP_RUNTIME_DIRRelocate the cached virtualenv. Default ~/.mitre-mcp-server/runtime/.
MITRE_MCP_DATA_DIRRelocate the ATT&CK data cache. Default ~/.mitre-mcp-server/data/.

From source

bash
git clone https://github.com/imouiche/complete-mitre-attack-mcp-server.gitcd complete-mitre-attack-mcp-serveruv syncuv run python -m mitre_mcp_server.server

Quick Start

1. Configure your client

Add the server to claude_desktop_config.json:

  • macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows — %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "mitre-attack": {      "command": "npx",      "args": ["-y", "@imouiche/mitre-attack-mcp-server"]    }  }}

2. Restart the client

Quit Claude Desktop completely (Cmd+Q on macOS) and reopen it.

3. Query

"What techniques does APT29 use for initial access?"

"Generate an ATT&CK Navigator layer for ransomware groups"

"Show me all Windows persistence techniques"


Security

MCPRush rates this server security A with low access scope and no sign-in required. That assessment is MCPRush's own, not an independent audit, but it reflects properties you can verify directly in this repository:

  • No credentials. The server reads no API keys, tokens or secrets. The only environment variables it consults are the three cache-location overrides documented above.
  • Narrow network scope. The sole outbound request is the ATT&CK STIX download, performed by MITRE's own mitreattack-python library. There are no telemetry, analytics or third-party calls.
  • Integrity-checked data. Downloads are verified against the expected hash published in MITRE's release manifest, so a corrupted or substituted bundle is rejected rather than loaded.
  • Local execution. The server runs as a local stdio process. It opens no listening port and exposes no HTTP surface.
  • Read-only behaviour. All 65 tools are queries over the cached STIX data. Nothing mutates state outside the cache directory, and no tool executes shell commands or evaluates caller-supplied code.

Found a security issue? Please open an issue.


Data Cache

The server does not bundle ATT&CK data. On first start it downloads the official STIX 2.1 bundles for all three domains and caches them on disk, then loads them into memory. Later starts reuse the cache and skip the download.

Location — ~/.mitre-mcp-server/data/v{version}/, overridable with MITRE_MCP_DATA_DIR.

Current release — ATT&CK v20.1, about 64MB across three files:

DomainFileSize
Enterpriseenterprise-attack.json52.7MB
Mobilemobile-attack.json5.9MB
ICSics-attack.json5.1MB

Clearing the cache to force a re-download

The cache is never invalidated automatically. If the data is stale, partially downloaded, or corrupted, clear it and the server will fetch a fresh copy the next time it starts.

Inspect what is currently cached:

bash
python -m mitre_mcp_server.data.download --stats

Re-download the current release, replacing what is there:

bash
python -m mitre_mcp_server.data.download --force

Or simply delete the cache and let the server re-fetch on next start. This is the most reliable method and the one to use with the npm install, which has no convenient python on PATH:

bash
rm -rf ~/.mitre-mcp-server/data

To refresh a single domain rather than all three:

bash
python -m mitre_mcp_server.data.download --domain enterprise --force

Reclaiming disk space from superseded releases

When MITRE publishes a new ATT&CK version, the server downloads it into a new v{version} directory and leaves the previous one in place. Over time these accumulate — a machine that has run through two releases will hold both:

~/.mitre-mcp-server/data/├── v18.1/   56MB   <- superseded, safe to delete└── v20.1/   64MB   <- in use

Only the directory matching the current mitreattack-python release is read. Delete the others:

bash
ls ~/.mitre-mcp-server/data/                       # list cached releasespython -m mitre_mcp_server.data.download --stats    # show which one is in userm -rf ~/.mitre-mcp-server/data/v18.1               # remove a superseded release

The npm install path keeps a second cache, the virtualenv under ~/.mitre-mcp-server/runtime/. It is keyed by package and Python version, so upgrades create a new directory and leave the old one behind. Removing the whole runtime directory is safe; it is rebuilt on the next launch.


Available Tools

65 tools covering the major ATT&CK entities and their relationships. All tool handlers are asynchronous. Most accept an optional domain argument of enterprise, mobile or ics, defaulting to enterprise.

Infrastructure and metadata

ToolDescription
get_data_statsDownload status, file paths, sizes and ATT&CK release version
get_statsEntity counts for a loaded domain
get_all_matricesAll ATT&CK matrices in a domain
generate_layerGenerate an ATT&CK Navigator layer as JSON
get_layer_metadataReturn a Navigator layer metadata template

Generic STIX access

Lower-level accessors that work across every object type, useful when you hold a STIX ID rather than an ATT&CK ID.

ToolDescription
get_object_by_attack_idAny object by ATT&CK ID and STIX type
get_object_by_stix_idAny object by STIX ID (UUID)
get_objects_by_typeAll objects of a given STIX type
get_objects_by_nameObjects by exact name match (case-sensitive)
get_objects_by_contentObjects whose description contains given text
get_attack_idConvert a STIX UUID to its ATT&CK ID
get_nameResolve the display name for a STIX ID
get_stix_typeDetermine the STIX object type for a STIX ID
get_objects_created_afterObjects created after a timestamp
get_objects_modified_afterObjects modified after a timestamp

Techniques

ToolDescription
get_technique_by_idGet a technique by ATT&CK ID, for example T1055
search_techniquesSearch techniques by name or description
get_all_techniquesRetrieve all techniques
get_all_parent_techniquesParent techniques only
get_all_subtechniquesAll sub-techniques
get_subtechniques_of_techniqueSub-techniques of a parent
get_parent_technique_of_subtechniqueParent of a sub-technique
get_technique_tacticsTactics associated with a technique
get_techniques_by_tacticTechniques under a tactic
get_techniques_by_platformTechniques for a platform
get_revoked_techniquesRevoked techniques

Groups

ToolDescription
get_group_by_nameFind a group by name or alias
search_groupsSearch groups
get_all_groupsAll ATT&CK groups
get_groups_by_aliasLook up groups by alias
get_groups_using_techniqueGroups using a technique
get_groups_using_softwareGroups using software
get_groups_attributing_to_campaignGroups attributed to a campaign
get_group_techniquesTechniques used by a group, by group name
get_techniques_used_by_groupTechniques used by a group, by STIX ID
get_techniques_used_by_group_softwareTechniques reachable via a group's software (group to software to techniques)

Software

ToolDescription
get_softwareGet all software
search_softwareSearch software
get_software_by_aliasLook up software by alias
get_software_used_by_groupSoftware used by a group
get_software_used_by_campaignSoftware used in campaigns
get_software_using_techniqueSoftware using a technique
get_all_softwareAll malware and tools in a domain
get_techniques_used_by_softwareTechniques used by specific software or malware

Campaigns

ToolDescription
get_all_campaignsGet all campaigns
get_campaigns_by_aliasLook up campaigns by alias
get_campaigns_using_techniqueCampaigns using a technique
get_campaigns_using_softwareCampaigns using software
get_campaigns_attributed_to_groupCampaign attribution
get_techniques_used_by_campaignTechniques used in a campaign

Mitigations

ToolDescription
get_all_mitigationsGet all mitigations
get_mitigations_mitigating_techniqueMitigations for a technique
get_techniques_mitigated_by_mitigationTechniques mitigated by a mitigation

Tactics, data sources and ICS

ToolDescription
get_all_tacticsGet all tactics
get_all_datasourcesGet all data sources
get_all_datacomponentsGet all data components
get_datacomponents_detecting_techniqueData components detecting a technique
get_all_assetsGet ICS assets
get_assets_targeted_by_techniqueAssets targeted by a technique
get_techniques_targeting_assetTechniques targeting an ICS asset
get_tactics_by_matrixTactics belonging to a matrix
get_tactics_by_techniqueTactics associated with a technique, by STIX ID
get_techniques_detected_by_datacomponentTechniques a data component can detect
get_procedure_examples_by_techniqueProcedure examples showing how groups used a technique
get_procedure_examples_by_tacticProcedure examples for all techniques in a tactic

Example Queries

What techniques does APT29 use for initial access?Which groups use Cobalt Strike?What are the aliases for the Lazarus Group?
What data sources detect credential dumping?What can detect T1055 (Process Injection)?List all techniques for Windows privilege escalationShow me lateral movement techniques for Linux
What mitigations exist for phishing attacks?What techniques does MFA mitigate?
Generate a layer for all techniques our EDR coversCompare APT29 TTPs against our detection capabilitiesShow unmitigated techniques in our environment

ATT&CK Navigator Visualisation

The generate_layer tool produces ATT&CK Navigator-compatible JSON.

  1. Ask your client to generate a layer, for example "Generate an ATT&CK Navigator layer for all techniques used by APT29"
  2. Save the JSON output to a file, for example apt29_layer.json
  3. Upload it to ATT&CK Navigator

Typical uses include mapping red-team exercise coverage, highlighting unmonitored techniques, profiling a threat actor's TTPs, and showing which techniques are mitigated against which are exposed.

Worked example with LangGraph


Technical Details

Architecture

  • Language — Python 3.12 or newer
  • Protocol — Model Context Protocol via FastMCP, served over stdio
  • Data source — official STIX 2.1 bundles through mitreattack-python
  • Concurrency — asynchronous tool handlers
  • Caching — all three domains loaded into memory at startup, so queries need no disk access

Data

PropertyValue
ATT&CK releasev20.1
DomainsEnterprise, Mobile, ICS
Techniques706 Enterprise, 125 Mobile, 104 ICS
Groups178 Enterprise, 20 Mobile, 14 ICS
Software842 Enterprise, 129 Mobile, 25 ICS
Mitigations44 Enterprise, 13 Mobile, 53 ICS
Tactics15 Enterprise, 12 Mobile, 12 ICS
Cache sizeabout 64MB
Cache location~/.mitre-mcp-server/data/v{version}/

Counts track the pinned ATT&CK release and change when MITRE publishes a new one. See Data Cache for refreshing.

Requirements

  • Python — 3.12 or newer
  • Node.js — 16 or newer, for the npm installation path only
  • Disk — about 64MB of ATT&CK data plus about 200MB of Python dependencies. The npm path keeps its dependencies in its own virtualenv, so budget roughly 290MB under ~/.mitre-mcp-server/.
  • Memory — about 490MB resident with all three domains loaded, since every domain is held in memory for fast queries. Measured on Python 3.12 against ATT&CK v20.1.
  • mcp — pinned to >=1.1.0,<2. The server uses the v1 mcp.server.fastmcp API, which mcp 2.0 renamed to MCPServer. An unpinned install resolves 2.x and fails at import.

License

Apache License 2.0. See LICENSE.

Issues and pull requests are welcome at github.com/imouiche/complete-mitre-attack-mcp-server.


Author

Inoussa Mouiche, Ph.D. — University of Windsor, WASP Lab. Research in threat intelligence automation, machine learning, multi-agent security systems and LLM-powered security operations.

GitHub · LinkedIn · Google Scholar · [email protected]


Acknowledgments

Built on MITRE ATT&CK using mitreattack-python, MITRE's official library, and implementing the Model Context Protocol. Thanks to the MCP developer community, including R. Jasper.

MITRE ATT&CK is a registered trademark of The MITRE Corporation. This project is not affiliated with or endorsed by The MITRE Corporation.

來源:README.md,提交 e5278c9

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次,以列出其工具,但未能完成:伺服器未能啟動。

版本歷史

2
  1. v0.1.6最新Nov 14, 2026
  2. v0.1.1Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分