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 分