Skip to main content

MCP server for ATT&CK queries via AI assistants

Project description

attack-query-mcp

PyPI version PyPI downloads Python 3.10+ License: MIT

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]

Resource Templates

The MCP server also provides resource templates for detailed lookups:

URI Template Description
attack://groups/{id} Get details for a specific group (by ID, name, or alias)
attack://techniques/{id} Get details for a specific technique (by ID like T1566)

Example Resource Template Usage

User: Tell me about APT28
AI: [reads attack://groups/APT28 resource]

User: What is technique T1566?
AI: [reads attack://techniques/T1566 resource]

User: Who is Fancy Bear?
AI: [reads attack://groups/Fancy%20Bear resource]

Requirements

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

attack_query_mcp-0.3.0.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

attack_query_mcp-0.3.0-py3-none-any.whl (13.5 kB view details)

Uploaded Python 3

File details

Details for the file attack_query_mcp-0.3.0.tar.gz.

File metadata

  • Download URL: attack_query_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 17.4 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

Hashes for attack_query_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 f03f7df8ae82706f540918a5acbd3c0fd8b7b128375858775c3f6226dd0ad7c9
MD5 8991d5906eaf8ddc40e6fd63394f1e0f
BLAKE2b-256 c0faa50420d68b0dd74a1d0cf2ff113348ab602b14f0987957aa3dd53f94cc39

See more details on using hashes here.

File details

Details for the file attack_query_mcp-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: attack_query_mcp-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 13.5 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

Hashes for attack_query_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 46f66d652c0f5685990afbeb4942928702dd94bce3960ea47b6c4d1ef5e2e762
MD5 9f0cf7edbee750679df84bf2aec7a66e
BLAKE2b-256 8be386329c024bed09dfc5ac1bdc7cf16114a1514388e39f2bc65127f31c2945

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page