stig-mcp
A local MCP (Model Context Protocol) server that lets an AI assistant, such as GitHub Copilot in VS Code or Claude Code, answer security questions from published guidance instead of from memory. Name a MITRE ATT&CK® technique or threat actor and the system you care about, and the answer gives you:
- the NIST SP 800-53 security controls that mitigate it;
- the DISA STIG configuration rules that implement those controls on that system, most severe first, with DISA's check and fix text on request;
- ATT&CK's own mitigations, and which of its detections work with the logs you collect.
It does not scan or connect to your systems. Its answers come from a knowledge base, a local database of about 6 MB built from those public sources, which you install once. The user guide explains what it does and shows three ways to use it: as a security controls assessor, a system owner, or a SOC analyst.
Prerequisite
stig-mcp is published on PyPI and runs through uvx,
which comes with uv.
Install uv, then check that
uvx --version runs in a new terminal. Restart VS Code or Claude Code after installing uv
so it sees the new PATH.
Quick start
VS Code (GitHub Copilot)
-
Click this badge. VS Code opens and offers to install stig-mcp; choose Install.
-
Open Copilot Chat and set the mode dropdown to Agent. MCP tools are not available in Ask or Edit mode.
-
Ask:
Install the stig-mcp knowledge base.This is a one-time download of about 6 MB. Allow the tool when VS Code asks.
If that doesn't work, see troubleshooting or setting up VS Code by hand.
Claude Code
-
Inside a Claude Code session (2.1.275 or later), run:
/plugin install stig-mcp --marketplace jeneric/STIG-MCP -
Ask:
Install the stig-mcp knowledge base.This is a one-time download of about 6 MB. Allow the tool when Claude Code asks.
If that doesn't work, see troubleshooting or setting up Claude Code by hand.
Example prompts
With the knowledge base installed, try:
- System owner:
What DISA STIG steps mitigate T1078 on Windows 11? - Security controls assessor:
Which ATT&CK techniques does APT29 use? - Anyone, to find the right STIG:
Which STIG benchmarks apply to RHEL 9? - SOC analyst:
What can I detect of APT29 on Windows Server 2022 with Security and Sysmon logs?
More example prompts are in the user guide, with how to get more out of it and how to make sure the agent answers from the server.
Other MCP clients
Use this only if you are not using VS Code or Claude Code. Any client that launches a local
(stdio) MCP server works with this configuration, shown in the common mcpServers shape:
{
"mcpServers": {
"stig-mcp": {
"command": "uvx",
"args": ["stig-mcp"],
"env": { "UV_SYSTEM_CERTS": "true", "UV_NATIVE_TLS": "true" }
}
}
}
The two environment variables let uv download stig-mcp behind a TLS-inspecting proxy. They are harmless on most other hosts; that section names the one exception. Then ask the agent to install the stig-mcp knowledge base, as in the quick start.
docs/install.md has the details:
- manual VS Code and Claude Code setup
- running from a source checkout
- installing the knowledge base without an agent or without network access
- where the data lives
- troubleshooting
What this server fetches
- The MCP server contacts nothing unless
check_sourcesorinstall_knowledge_baseis called. Then it sends HTTPS GET requests toapi.github.com(this repository's release listing) andgithub.com(/jeneric/STIG-MCP/releases/download/...), which redirects torelease-assets.githubusercontent.comorobjects.githubusercontent.com. Any other URL, a redirect included, is refused. Nothing is uploaded, and there is no telemetry.install_knowledge_basegiven a file path and its SHA-256 requests nothing at all. stig-mcp-install-kbcontacts the same hosts, and nothing at all with--file.stig-mcp-fetch, used only to build the knowledge base yourself, downloads fromraw.githubusercontent.comandapi.github.com(MITRE ATT&CK, the CTID mapping, the NIST 800-53 catalog) and fromwww.cyber.milanddl.dod.cyber.mil(DISA).
PRIVACY.md states what each of these requests sends and what is stored locally.
Documentation
- docs/install.md: installation details for every client, where the data lives, and troubleshooting.
- docs/user-guide.md: for a person talking to an LLM that has this server wired in.
- docs/operations.md: for whoever installs, builds and maintains the knowledge base.
- SECURITY.md: reporting a vulnerability, and what is in scope.
- CONTRIBUTING.md: working from a source checkout, running the tests, and the project's conventions.
- RELEASING.md: for the maintainer, publishing the package to PyPI and the MCP Registry.
- PRIVACY.md: what the server and the fetch tool contact, and what is stored locally.
Third-party content
The knowledge base aggregates MITRE ATT&CK, CTID mapping, DISA STIG, DISA CCI list, and NIST OSCAL content. See NOTICE for attribution and licensing obligations and licenses/apache-2.0.txt for the Apache 2.0 license text that notice requires.
Development
Developed with the assistance of Claude Code (Anthropic). All changes were reviewed and tested by the maintainer.
Metadata
Release files for stig-mcp 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stig_mcp-0.2.1.tar.gz | 166.4 kB | With provenance | Details for stig_mcp-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stig_mcp-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for stig_mcp-0.2.1-py3-none-any.whl |
Total release size: 346.5 kB
Release files / stig_mcp-0.2.1.tar.gz
| Download URL | stig_mcp-0.2.1.tar.gz |
|---|---|
| Size | 166.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8924219018e8873658cf87610ae00dda09e469d281a08715a328425ac889b519
|
|
BLAKE2b-256 checksum How to use checksums |
d3a3aa906bcccdbdb6d9f13f612c91d444358a2f50994e8e02508bee55bee89d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.
Transparency logRelease files / stig_mcp-0.2.1-py3-none-any.whl
| Download URL | stig_mcp-0.2.1-py3-none-any.whl |
|---|---|
| Size | 180.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0481004684f78d872a4e12d7f4d1be5de1dde873b8ab11634c7fa9ef5e9f2219
|
|
BLAKE2b-256 checksum How to use checksums |
5f1e609431bb7425b4adc5ab9c2410bbc50ce351dc74ac1d9f6fdf271ed3021f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.
Transparency logSecurity for stig-mcp 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for stig_mcp-0.2.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.