nist-mcp
nist-mcp
一个小型模型上下文协议 (MCP) 服务器,为 AI 助手提供对 NIST 网络安全目录的结构化访问:出版物、SP 800-53 Rev 5 控制、CSF 2.0、CMVP 模块、NCP 清单、术语表、NICE 工作角色以及实时的 NVD CVE/CPE 数据。本地 NIST 数据由 SQLite 索引提供,该索引在首次使用时通过直接从 NIST 下载结构化数据自动构建。
安装
直接从 GitHub 安装:
pipx install git+https://github.com/ball2jh/nist-mcp.git
# or
pip install git+https://github.com/ball2jh/nist-mcp.git用于本地开发:
git clone https://github.com/ball2jh/nist-mcp.git
cd nist-mcp
pip install -e ".[dev,scraper]"Related MCP server: NIST NVD MCP Server
配置
环境变量
变量 | 默认值 | 描述 |
|
| 本地数据库和缓存文档的目录 |
| (无) | 可选的 NVD API 密钥,用于更高的速率限制(推荐) |
|
| 后台数据库重建之间的秒数(默认:7 天) |
config.toml
创建 ~/.nist-mcp/config.toml(或 $NIST_MCP_DATA_DIR/config.toml)以进行持久化设置:
nvd_api_key = "your-api-key-here"
update_interval = 43200 # 12 hours环境变量的优先级高于配置文件。
MCP 客户端配置
添加到您的 MCP 客户端服务器列表中(例如 Claude Desktop 的 claude_desktop_config.json):
{
"mcpServers": {
"nist": {
"command": "nist-mcp",
"env": {
"NIST_MCP_NVD_API_KEY": "your-api-key-here"
}
}
}
}首次运行时,服务器会通过从 NIST 下载结构化数据来构建本地数据库(约 2 秒)。数据库会被缓存,并在过期时自动重建(默认:每 7 天)。
MCP 安全说明
此服务器旨在作为本地 stdio MCP 服务器运行。它不公开 HTTP 监听器,因此访问仅限于启动它的 MCP 客户端进程。日志通过 Python 日志记录写入,默认写入 stderr,不会损坏 stdio JSON-RPC 流量。
工具模式限制了常见的选项集和结果大小。文档下载仅限于来自已知 NIST 出版物主机的 HTTPS URL,重定向会经过重新验证,文件名在写入本地缓存前会进行清理,页面提取限制为每次请求最多 50 页。下载、缓存或重建本地数据的工具被标注为非破坏性,但并非纯只读,以便客户端可以提供适当的确认 UI。
可用工具
工具 | 描述 |
| 在出版物、控制、CSF、术语表、CMVP、清单和 NICE 中搜索本地 NIST 目录数据 |
| 按来源和 ID 获取单个本地 NIST 记录 |
| 下载/缓存并以 Markdown 格式读取出版物内容;默认返回 PDF 目录 |
| 搜索实时 NVD CVE 或 CPE 数据 |
| 获取包含 CVSS、弱点、参考、KEV 状态和可选变更历史的 CVE |
| 显示数据库构建日期、大小、新鲜度和文件路径 |
| 通过从 NIST 源下载最新数据来重建本地 NIST 索引 |
可用资源
URI | 描述 |
| 服务器版本、数据库新鲜度和快速入门工具指南 |
快速示例
查找关于零信任的 NIST 指南
search_nist("zero trust architecture")查找 SP 800-207 出版物
search_nist("zero trust", source="publications")
get_nist_record(source="publications", record_id="SP.800-207")查看中等(MODERATE)系统的访问控制要求
search_nist("account management", source="controls", detail="standard")
get_nist_record(source="controls", record_id="AC-2")分析 Log4Shell
get_cve("CVE-2021-44228")检查您的加密库是否经过 FIPS 验证
search_nist("OpenSSL", source="cmvp")查找关于事件响应的 CSF 指南
search_nist("incident response", source="csf")许可证
MIT 许可证。请注意,用于 PDF 转 Markdown 的 pymupdf4llm 采用 AGPL-3.0 许可证。
Available Tools
20 toolsdatabase_statusARead-onlyIdempotent
Show the current NIST metadata index status: build date, last update check, database size, and file path. Use this to verify the database is available and check data freshness.
Inputs: no named parameters. Returns: result
download_documentA
Download a publication PDF or supplemental material to local cache. Returns the file path. Use material_index to download a specific supplemental file listed in the get_publication output.
Inputs: publication_id (required), material_index. Returns: result
get_controlARead-onlyIdempotent
Get complete details for a specific SP 800-53 Rev 5 control: statement, guidance, parameters, related controls, baselines, and cross-framework mappings.
Set include_enhancements=True to also get all enhancement sub-controls. Do NOT use this for searching -- use search_controls to find controls first.
Inputs: control_id (required), include_enhancements. Returns: result
get_csf_dataARead-onlyIdempotent
Browse/search the NIST CSF 2.0 framework hierarchy. No args = list all 6 functions. function="PR" = Protect categories. category="PR.AC" = subcategories. query="risk" = full-text search. Includes count of mapped SP 800-53 controls per entry.
Inputs: function, category, query, detail_level. Returns: result
get_cveARead-only
Get full details for a CVE: description, CVSS scores, affected products (CPE), CWE classification, references, and CISA KEV status (if exploited: date added, due date, required action). Use this after search_cves to get complete vulnerability details. May take 6+ seconds without an NVD API key due to rate limiting.
Inputs: cve_id (required). Returns: result
get_cve_historyARead-only
Get the change history for a CVE — when it was modified, what changed (score updates, CPE additions, CWE remaps). May take 6+ seconds without an NVD API key due to rate limiting.
Inputs: cve_id (required). Returns: result
get_document_contentA
Retrieve publication content as Markdown. Without section/pages, returns table of contents. With section, returns that section. With pages, returns those pages. Handles PDF, XLSX, CSV, JSON, and XML formats. Results are cached locally.
Use this to read the actual content of NIST documents. For large documents like SP 800-53 (492 pages), use the pages parameter to request specific page ranges.
Inputs: publication_id (required), section, pages. Returns: result
get_framework_mappingsARead-onlyIdempotent
Cross-reference frameworks. 'What CSF maps to AC-1?' or 'What 800-53 controls implement PR.AC?' Bidirectional lookup in the mappings table.
Inputs: source_id (required), target_framework. Returns: result
get_latest_revisionARead-onlyIdempotent
Resolve any publication to its newest available revision. Follows the supersedes chain. Use this when you need the most current version of a document.
Inputs: publication_id (required). Returns: result
get_publicationARead-onlyIdempotent
Get full metadata for a specific NIST publication including title, abstract, authors, date, supersedes chain, related publications, and list of supplemental materials.
Inputs: publication_id (required). Returns: result
lookup_glossaryARead-onlyIdempotent
Look up NIST cybersecurity/privacy terms. Use 'term' for exact match, 'query' for keyword search. Returns definition, authoritative source, and related terms.
Inputs: term, query, limit. Returns: result
search_checklistsBRead-onlyIdempotent
Search NCP security configuration checklists. 'SCAP checklists for Windows Server 2022' or 'CIS benchmarks for Ubuntu'.
Inputs: product, format, authority, query, +2 more. Returns: result
search_cmvpARead-onlyIdempotent
Search FIPS 140-2/3 validated cryptographic modules. 'Is OpenSSL FIPS validated?' or 'Which modules support AES-256-GCM at Level 2?'
Inputs: vendor, module_name, fips_level, algorithm, +3 more. Returns: result
search_controlsARead-onlyIdempotent
Search NIST SP 800-53 Rev 5 security and privacy controls by keyword, family, or baseline. Accepts flexible ID formats (AC-2, ac-2, AC2 all work).
summary: label + title (~50 tokens/result) standard: + statement text + baselines (~200 tokens/result) full: + guidance + parameters + related controls (~500+ tokens/result)
Use get_control for the complete detail of a specific control including enhancements.
Inputs: query, family, baseline, include_withdrawn, +3 more. Returns: result
search_cpesARead-only
Search the NVD CPE (Common Platform Enumeration) database for products and platforms. May take 6+ seconds without an NVD API key due to rate limiting.
Inputs: keyword, match_string, limit, offset. Returns: result
search_cvesARead-only
Search the NVD CVE database. Supports keyword, CVSS severity, CPE product, CWE weakness type, and date range filters. Set has_kev=True for only CISA Known Exploited Vulnerabilities. Results include CVE ID, description, severity, and score. May take 6+ seconds without an NVD API key due to rate limiting.
Inputs: keyword, severity, cpe_name, cwe_id, +5 more. Returns: result
search_nice_rolesBRead-onlyIdempotent
Search NICE Framework work roles. 'What role handles incident response?'
Inputs: query, category, limit. Returns: result
search_nistARead-onlyIdempotent
Search across ALL NIST data: publications, SP 800-53 controls, CSF framework, glossary, CMVP modules, checklists, and NICE roles. Results grouped by type.
Use this as a starting point when you're not sure which specific tool to use. For targeted searches, use domain-specific tools (search_publications, search_controls, etc.).
scope options: publications, controls, csf, glossary, cmvp, checklists, nice
Inputs: query (required), scope, limit. Returns: result
search_publicationsARead-onlyIdempotent
Search NIST publications by keyword across all series (SP 800, SP 1800, FIPS, IR, CSWP, AI).
Returns matching publications with ID, title, date, and series. Use get_publication for full details on a specific publication. Default shows only the latest revision of each document. Do NOT use this for SP 800-53 security controls -- use search_controls instead.
Inputs: query (required), series, status, pub_type, +4 more. Returns: result
update_databaseA
Rebuild the NIST metadata index by downloading fresh data from NIST sources (XLSX, JSON, ZIP). Takes about 5-10 seconds. Use this if you need the most current publication or control data.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Most tools have distinct purposes with clear boundaries, such as get_control for detailed control information versus search_controls for finding controls. However, some overlap exists between search_nist and domain-specific search tools, which could cause confusion about which to use first, though descriptions help clarify their roles.
Tool names follow a highly consistent verb_noun pattern throughout, such as get_control, search_cves, and update_database. This predictability makes it easy for agents to understand and navigate the toolset without naming confusion.
With 20 tools, the count is slightly high but reasonable for the broad scope of NIST cybersecurity data, covering publications, controls, vulnerabilities, and frameworks. It might feel heavy, but each tool appears to serve a specific function without obvious redundancy.
The toolset provides comprehensive coverage for the NIST cybersecurity domain, including CRUD-like operations (e.g., get, search, update), cross-referencing, and content retrieval. No significant gaps are apparent, supporting full agent workflows from discovery to detailed analysis.
Maintenance
Related MCP Connectors
Search and audit NIST NVD CVEs by keyword, severity, CWE, CISA KEV status, and CPE.
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
Real-time CVE, exploit, and vulnerability intelligence for AI assistants (350K+ CVEs, 115K+ PoCs)
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides conversational access to a local CVE (Common Vulnerabilities and Exposures) database, enabling natural language queries to search vulnerabilities, retrieve detailed CVE information, and view security statistics.3MIT
- AlicenseAqualityCmaintenanceEnables AI agents to search, retrieve, and analyze vulnerability data from the NIST National Vulnerability Database through a comprehensive Model Context Protocol server.89MIT
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive access to NIST cybersecurity frameworks and controls, enabling AI assistants and applications to query, analyze, and manage NIST security controls through a standardized interface.10MIT
- AlicenseAqualityDmaintenanceProvides live CVE data from NVD and EPSS without API key, enabling AI assistants to look up CVSS scores, search vulnerabilities, and check product CVEs.3MIT