MCP server for ATT&CK queries via AI assistants
Project description
attack-query-mcp
MCP server for ATT&CK queries via AI assistants.
Overview
This package provides a Model Context Protocol (MCP) server that enables AI assistants like Claude to query MITRE ATT&CK data using natural language.
Installation
pip install attack-query-mcp
Usage
With Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"attack-query": {
"command": "attack-query-mcp"
}
}
}
Standalone
attack-query-mcp
Tools
The MCP server provides 7 tools for querying ATT&CK data:
| Tool | Description |
|---|---|
query_attack |
Natural language queries (e.g., "techniques used by APT28") |
get_technique |
Get technique details by ID (e.g., T1566) |
get_group |
Get group info by name, ID, or alias |
compare_groups |
Compare techniques between two groups with similarity metrics |
find_similar_groups |
Find groups with similar technique profiles |
get_mitigations |
Get mitigations for a technique |
export_navigator_layer |
Export techniques as Navigator layer JSON |
Example Tool Usage
User: What techniques does APT28 use for initial access?
AI: [calls query_attack with "techniques used by APT28 for initial access"]
User: Compare APT28 and APT29
AI: [calls compare_groups with group1="APT28", group2="APT29"]
User: What mitigations address phishing?
AI: [calls get_mitigations with technique_id="T1566"]
Resources
The MCP server exposes 6 resources for browsing ATT&CK data:
| URI | Description |
|---|---|
attack://groups |
List all threat groups with IDs, names, and aliases |
attack://techniques |
List all techniques with IDs, names, and tactics |
attack://tactics |
List all tactics in kill chain order |
attack://software |
List all software (malware and tools) |
attack://mitigations |
List all mitigations with technique counts |
attack://campaigns |
List all campaigns with dates and attribution |
Example Resource Usage
User: Show me all APT groups in ATT&CK
AI: [reads attack://groups resource]
User: What tactics are in the kill chain?
AI: [reads attack://tactics resource]
Requirements
- Python 3.10+
- attack-query library
License
MIT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file attack_query_mcp-0.2.1.tar.gz.
File metadata
- Download URL: attack_query_mcp-0.2.1.tar.gz
- Upload date:
- Size: 15.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.24 {"installer":{"name":"uv","version":"0.9.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6561218f7ba873500b5c516385b55b25af27e22d0641dac674defc7a53c924ca
|
|
| MD5 |
54df5c97b75424c9f83207f5d7caad55
|
|
| BLAKE2b-256 |
35e9bbdb3510bd54fb114a46971a75e6d824760eb9cd6e323652896797193814
|
File details
Details for the file attack_query_mcp-0.2.1-py3-none-any.whl.
File metadata
- Download URL: attack_query_mcp-0.2.1-py3-none-any.whl
- Upload date:
- Size: 11.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.24 {"installer":{"name":"uv","version":"0.9.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f648a3ba730ab55843188096810a958acc05d9e8de013210db8bcd5b67830c9e
|
|
| MD5 |
eeb0e1127fbcffc063f911b91bd06e62
|
|
| BLAKE2b-256 |
31ab6cfd0aafd5cee056cf01bd9243d56f8d9dcdbc2152af0ed1ddb0c1a85277
|