security-controls-mcp 0.2.0__py3-none-any.whl

security_controls_mcp-0.2.0.dist-info/METADATA

@@ -0,0 +1,467 @@
+Metadata-Version: 2.4
+Name: security-controls-mcp
+Version: 0.2.0
+Summary: MCP server for querying security framework controls (SCF) - map between ISO 27001, NIST CSF, DORA, PCI DSS, and more
+Author-email: Ansvar Systems <hello@ansvar.eu>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/Ansvar-Systems/security-controls-mcp
+Project-URL: Repository, https://github.com/Ansvar-Systems/security-controls-mcp
+Project-URL: Issues, https://github.com/Ansvar-Systems/security-controls-mcp/issues
+Keywords: mcp,security,compliance,iso27001,nist,dora,pci-dss
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE-DATA.md
+Requires-Dist: mcp>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Provides-Extra: import-tools
+Requires-Dist: pdfplumber>=0.11.0; extra == "import-tools"
+Requires-Dist: Pillow>=10.0.0; extra == "import-tools"
+Requires-Dist: click>=8.0.0; extra == "import-tools"
+Dynamic: license-file
+
+# Security Controls MCP Server
+
+[![MCP](https://img.shields.io/badge/MCP-0.9.0+-blue.svg)](https://modelcontextprotocol.io)
+[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org)
+[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](LICENSE)
+[![SCF](https://img.shields.io/badge/SCF-2025.4-orange.svg)](https://securecontrolsframework.com/)
+
+## Overview
+
+**The universal translator for security frameworks.**
+
+The Security Controls MCP Server is an open-source tool that makes 1,451 security controls across 16 frameworks searchable and AI-accessible directly through Claude, Cursor, or any MCP-compatible client.
+
+Built on the [Secure Controls Framework (SCF)](https://securecontrolsframework.com/) by ComplianceForge.
+
+## Key Features
+
+**Coverage:**
+- 1,451 security controls spanning governance, risk, compliance, and technical domains
+- 16 major frameworks including ISO 27001, NIST CSF, DORA, PCI DSS, CMMC, and more
+- Bidirectional mapping between any two frameworks via SCF rosetta stone
+- Optional integration with purchased standards (ISO, NIST 800-53) for official text
+
+**Capabilities:**
+- Full-text search across all control descriptions and names
+- Natural language queries instead of framework-specific control IDs
+- Cross-framework requirement comparison (e.g., "What DORA controls does ISO 27001 A.5.15 map to?")
+- Control filtering by framework, domain, or keyword
+- SCF control metadata including PPTDF categories and security domain weights
+
+**Integration:**
+- Works seamlessly with [EU Regulations MCP](https://github.com/Ansvar-Systems/eu-regulations-mcp) for complete EU compliance coverage
+
+---
+
+## Why This Exists
+
+When you're implementing security controls, you face a common problem: different frameworks describe the same security measures in different ways. ISO 27001 has one control ID, NIST CSF has another, PCI DSS has yet another — but they're all talking about the same thing.
+
+This MCP server solves that by giving you instant **bidirectional mapping** between any two frameworks via the SCF rosetta stone. Ask Claude "What DORA controls does ISO 27001 A.5.15 map to?" and get an immediate, authoritative answer backed by ComplianceForge's comprehensive framework database.
+
+**Works with:** [EU Regulations MCP](https://github.com/Ansvar-Systems/eu-regulations-mcp) for complete EU compliance coverage (DORA + NIS2 + AI Act + GDPR + more).
+
+---
+
+## 🔒 Add Your Purchased Standards (Optional)
+
+**NEW:** Import your purchased ISO 27001, NIST SP 800-53, or other standards to get:
+
+✅ **Official text** from your licensed copies alongside SCF descriptions
+✅ **Full clauses** with page numbers for compliance research
+✅ **Enhanced queries** - see both SCF mappings AND official requirements
+
+Your paid content stays private in `~/.security-controls-mcp/` (never committed to git).
+
+**Quick example:**
+```bash
+# Install import tools
+pip install -e '.[import-tools]'
+
+# Import your purchased PDF
+scf-mcp import-standard \
+  --file ~/Downloads/ISO-27001-2022.pdf \
+  --type iso_27001_2022 \
+  --title "ISO/IEC 27001:2022"
+
+# Restart MCP, then query:
+# "Show me GOV-01 with official ISO 27001 text"
+```
+
+**📖 Full Guide:** [PAID_STANDARDS_GUIDE.md](PAID_STANDARDS_GUIDE.md) - Complete setup, troubleshooting, and license compliance information.
+
+---
+
+## Installation & Setup
+
+### Quick Install (Recommended)
+
+**Option 1: Using pipx (Recommended)**
+```bash
+pipx install security-controls-mcp
+```
+
+**Option 2: Using pip**
+```bash
+pip install security-controls-mcp
+```
+
+**Option 3: From Source**
+```bash
+git clone https://github.com/Ansvar-Systems/security-controls-mcp.git
+cd security-controls-mcp
+pip install -e .
+```
+
+**Requirements:**
+- Python 3.10 or higher
+- pip or pipx
+
+### Development Setup (For Contributors)
+
+If you're contributing to the project, install development tools and pre-commit hooks:
+
+```bash
+# Install development dependencies
+pip install -e '.[dev]'
+
+# Install pre-commit hooks (runs tests/linting before each commit)
+pre-commit install
+```
+
+Pre-commit hooks automatically run before each commit:
+- **Code formatting** - black, ruff (auto-fixes)
+- **Linting** - ruff check, YAML/JSON validation
+- **Tests** - pytest, smoke tests, server startup test
+
+**Bypass hooks (emergencies only):**
+```bash
+git commit --no-verify
+```
+
+**Run hooks manually:**
+```bash
+# All hooks on all files
+pre-commit run --all-files
+
+# Specific hook
+pre-commit run black --all-files
+```
+
+### Claude Desktop Configuration
+
+After installation, add to `claude_desktop_config.json`:
+
+**If installed via pip/pipx:**
+```json
+{
+  "mcpServers": {
+    "security-controls": {
+      "command": "scf-mcp"
+    }
+  }
+}
+```
+
+**If installed from source:**
+```json
+{
+  "mcpServers": {
+    "security-controls": {
+      "command": "python",
+      "args": ["-m", "security_controls_mcp"],
+      "cwd": "/path/to/security-controls-mcp"
+    }
+  }
+}
+```
+
+**Config file location:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Cursor / VS Code Configuration
+
+Same configuration under `"mcp.servers"` instead of `"mcpServers"` in your settings.
+
+### Testing
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Or run quick validation
+python test_server.py
+```
+
+**📖 Full Documentation:**
+- **[INSTALL.md](INSTALL.md)** - Detailed setup instructions
+- **[TESTING.md](TESTING.md)** - Validation steps and example queries
+- **[PAID_STANDARDS_GUIDE.md](PAID_STANDARDS_GUIDE.md)** - Import purchased standards for official text
+
+---
+
+## Example Queries
+
+Ask Claude these natural language questions:
+
+- *"What does GOV-01 require?"*
+- *"Search for controls about encryption key management"*
+- *"What ISO 27001 controls map to DORA?"*
+- *"List all controls needed for PCI DSS compliance"*
+- *"Which DORA requirements does ISO 27001 A.5.15 satisfy?"*
+- *"Show me all NIST CSF 2.0 controls related to incident response"*
+- *"Map CMMC Level 2 controls to FedRAMP requirements"*
+
+---
+
+## Available Frameworks (16 Total)
+
+When you call `list_frameworks()`, you get:
+
+```
+Available Frameworks (16 total)
+
+- nist_800_53_r5: NIST SP 800-53 Revision 5 (777 controls)
+- soc_2_tsc: SOC 2 (TSC 2017:2022) (412 controls)
+- pci_dss_4.0.1: PCI DSS v4.0.1 (364 controls)
+- fedramp_r5_moderate: FedRAMP Revision 5 (Moderate) (343 controls)
+- iso_27002_2022: ISO/IEC 27002:2022 (316 controls)
+- nist_csf_2.0: NIST Cybersecurity Framework 2.0 (253 controls)
+- cis_csc_8.1: CIS Critical Security Controls v8.1 (234 controls)
+- cmmc_2.0_level_2: CMMC 2.0 Level 2 (198 controls)
+- hipaa_security_rule: HIPAA Security Rule (136 controls)
+- dora: Digital Operational Resilience Act (DORA) (103 controls)
+- nis2: Network and Information Security Directive (NIS2) (68 controls)
+- ncsc_caf_4.0: NCSC Cyber Assessment Framework 4.0 (67 controls)
+- cmmc_2.0_level_1: CMMC 2.0 Level 1 (52 controls)
+- iso_27001_2022: ISO/IEC 27001:2022 (51 controls)
+- gdpr: General Data Protection Regulation (GDPR) (42 controls)
+- uk_cyber_essentials: UK Cyber Essentials (26 controls)
+```
+
+**Framework categories:**
+- **Government:** NIST 800-53, NIST CSF, FedRAMP, CMMC
+- **International Standards:** ISO 27001, ISO 27002, CIS CSC
+- **Industry:** PCI DSS, SOC 2, HIPAA
+- **EU Regulations:** DORA, NIS2, GDPR
+- **UK Standards:** NCSC CAF, Cyber Essentials
+
+---
+
+## Tools
+
+### 1. `get_control`
+Get details about a specific SCF control by ID.
+
+```python
+get_control(control_id="GOV-01")
+```
+
+**Returns:** Full control details including description, domain, weight, PPTDF category, and mappings to all 16 frameworks.
+
+---
+
+### 2. `search_controls`
+Search for controls by keyword in name or description.
+
+```python
+search_controls(query="encryption", limit=10)
+```
+
+**Optional parameters:**
+- `frameworks` - Filter to specific frameworks (e.g., `["dora", "iso_27001_2022"]`)
+- `limit` - Maximum results (default: 10)
+
+---
+
+### 3. `list_frameworks`
+List all available frameworks with metadata.
+
+```python
+list_frameworks()
+```
+
+**Returns:** All 16 frameworks with display names and control counts.
+
+---
+
+### 4. `get_framework_controls`
+Get all SCF controls that map to a specific framework.
+
+```python
+get_framework_controls(framework="dora")
+```
+
+**Returns:** All controls with mappings to the specified framework, organized by domain.
+
+---
+
+### 5. `map_frameworks`
+Map controls between two frameworks via SCF.
+
+```python
+map_frameworks(
+  source_framework="iso_27001_2022",
+  source_control="A.5.15",  # Optional: filter to specific control
+  target_framework="dora"
+)
+```
+
+**Returns:** SCF controls that map to both frameworks, showing the connection between them.
+
+---
+
+### 6. `list_available_standards`
+List all available standards including built-in SCF and any purchased standards you've imported.
+
+```python
+list_available_standards()
+```
+
+**Returns:** List of available standards with metadata (type, title, import date).
+
+---
+
+### 7. `query_standard`
+Search within a specific purchased standard (requires import first).
+
+```python
+query_standard(
+  standard="iso_27001_2022",
+  query="access control",
+  limit=10
+)
+```
+
+**Returns:** Relevant clauses/sections from the purchased standard with page numbers.
+
+---
+
+### 8. `get_clause`
+Get the full text of a specific clause from a purchased standard.
+
+```python
+get_clause(
+  standard="iso_27001_2022",
+  clause_id="5.15"
+)
+```
+
+**Returns:** Complete clause text with metadata from your purchased standard.
+
+**Note:** Tools 6-8 require purchased standards to be imported first. See [PAID_STANDARDS_GUIDE.md](PAID_STANDARDS_GUIDE.md) for setup.
+
+---
+
+## Technical Architecture
+
+**Data Pipeline:**
+SCF JSON → In-memory index → MCP tools → AI response
+
+**Key Principles:**
+- All control text returns verbatim from SCF source data with zero LLM paraphrasing
+- Framework mappings use ComplianceForge's authoritative control crosswalks
+- Optional purchased standards stored locally in `~/.security-controls-mcp/` (never committed)
+
+**Context Management:**
+- Search results optimized for AI context windows
+- Full control retrieval includes all framework mappings
+- Cross-framework queries use bidirectional SCF mapping indices
+
+**Data Integrity:**
+- SCF version locked to 2025.4 for consistency
+- Optional standards imported from user-purchased PDFs (with license compliance)
+- All mappings sourced from official SCF framework crosswalks
+
+---
+
+## Data Source
+
+Based on **SCF 2025.4** released December 29, 2025.
+
+- **1,451 controls** across all domains
+- **180+ framework mappings** (16 frameworks × 0-777 controls each)
+- Licensed under **Creative Commons** (data)
+- Source: [ComplianceForge SCF](https://securecontrolsframework.com/)
+
+**Data files included in package:**
+- `scf-controls.json` - All 1,451 controls with framework mappings
+- `framework-to-scf.json` - Reverse index for framework-to-SCF lookups
+
+---
+
+## Important Disclaimers
+
+**Not Legal or Compliance Advice:** Control text is sourced directly from official SCF data, but framework mappings and control interpretations are provided for research purposes only. This tool should not be used as the sole basis for compliance decisions. Always verify against official framework sources and consult qualified compliance professionals and auditors for your specific regulatory requirements.
+
+**AI Content Restrictions:** The SCF license explicitly prohibits using AI systems to generate derivative content such as policies, standards, procedures, metrics, risks, or threats based on SCF data. You may query and analyze controls, but not generate derivative compliance artifacts.
+
+**Purchased Standards:** Optional standards imports (ISO, NIST) require valid licenses. You must own legitimate copies and comply with copyright restrictions. This tool does not include or distribute any copyrighted standards text.
+
+**Framework Coverage:** While SCF provides comprehensive mappings, not all controls map 1:1 across frameworks. Some controls may be interpreted, consolidated, or split during mapping. Always review official framework documentation for authoritative requirements.
+
+---
+
+## Developer Information
+
+**Built by:** [Ansvar Systems](https://ansvar.eu) (Stockholm, Sweden) — specializes in AI-accelerated threat modeling and compliance tools
+
+**License:** Apache License 2.0 (code) / CC BY-ND 4.0 (data)
+
+**Documentation:**
+- [INSTALL.md](INSTALL.md) - Complete installation guide for all platforms
+- [TESTING.md](TESTING.md) - Validation steps and example queries
+- [PAID_STANDARDS_GUIDE.md](PAID_STANDARDS_GUIDE.md) - Import purchased standards
+- [LEGAL_COMPLIANCE.md](LEGAL_COMPLIANCE.md) - License requirements and restrictions
+
+**Related Projects:**
+- **[EU Regulations MCP](https://github.com/Ansvar-Systems/eu-regulations-mcp)** - Query 37 EU regulations (AI Act, DORA, NIS2, GDPR, etc.) for complete EU compliance coverage
+
+---
+
+## License
+
+### Code License
+
+The source code in this repository is licensed under the **Apache License 2.0** (see [LICENSE](LICENSE)).
+
+### Data License
+
+The SCF control data (`scf-controls.json`, `framework-to-scf.json`) is licensed under the **Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)** by ComplianceForge.
+
+- **Source:** [Secure Controls Framework (SCF)](https://securecontrolsframework.com/)
+- **License:** [CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0/)
+- **Copyright:** ComplianceForge
+- **Version:** SCF 2025.4 (Released December 29, 2025)
+
+#### ⚠️ Important: AI Derivative Content Restriction
+
+The SCF license **explicitly prohibits** using AI systems (including Claude) to generate derivative content such as policies, standards, procedures, metrics, risks, or threats based on SCF data.
+
+**You MAY:**
+- Query and analyze SCF controls
+- Map between frameworks (e.g., "What DORA controls does ISO 27001 A.5.15 map to?")
+- Reference controls in your own work (with proper attribution)
+- Use this MCP server to understand control requirements
+
+**You MAY NOT:**
+- Ask Claude (or any AI) to generate policies or procedures based on SCF controls
+- Create derivative frameworks or modified versions for distribution
+- Remove or modify control definitions
+
+For complete terms and conditions, see: [SCF Terms & Conditions](https://securecontrolsframework.com/terms-conditions/)

security_controls_mcp-0.2.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+security_controls_mcp/__init__.py,sha256=-331-VrKgRg6Va-GKynT7P1SesVazmZHN0Mwfq7_49s,108
+security_controls_mcp/__main__.py,sha256=4qAnCoMWk197dfiYhSjKJjYWpM-ZCQEHDu6dhZmf3Co,132
+security_controls_mcp/cli.py,sha256=7LoL0pJOVIrvfvZn7TfBb9V8sLg8UdDBn35JI5c9r3s,7540
+security_controls_mcp/config.py,sha256=7MW9pxKf9Fc0A8D25VW9SqSJbTMWw5r7mSezX164-oQ,4996
+security_controls_mcp/data_loader.py,sha256=-JiOX8O8owTyADkMPZplRhEvDz_5wW5E-OyNi-NCx1Q,6883
+security_controls_mcp/http_server.py,sha256=NL7hSJ_1L1RV3zNYt_z-BXrVNKY8gjqV9dZ-M2Bp-gQ,16785
+security_controls_mcp/legal_notice.py,sha256=078PKSwxc0-MYt9NxCXp0ayAGOcRffLwbIWAkq-cXi8,4330
+security_controls_mcp/providers.py,sha256=GrKpLnqqxnktoq1yIuxKCyE23IKql6XZ6O_E_iE1GzA,8547
+security_controls_mcp/registry.py,sha256=aPbI_zFF7XzjIif1wGE4o2Rd_0HbJvOeNSe0xWHKG_o,4417
+security_controls_mcp/server.py,sha256=SHzp9Iu0qdStU0imh9KMjtJjOolozhJC-FJAHM6d9ZY,24667
+security_controls_mcp/data/framework-to-scf.json,sha256=2frpsqOtxf5EOBJbm3TaeRYz6fT5xykCaUsmYHpZmqk,199403
+security_controls_mcp/data/scf-controls.json,sha256=7cfgsTmf56i4depNKqZqdjUK0qNt8ybdZJQN906yRZk,1540302
+security_controls_mcp/extractors/__init__.py,sha256=_dQ1HOD7gTyw2FwQMMtgVTYQVSpxIdwBwqsdkSo1nyE,143
+security_controls_mcp/extractors/pdf_extractor.py,sha256=nYd8mbKn_ejeEm02VZrFColRIfYFbP_oOuUm2SfOVqc,7490
+security_controls_mcp-0.2.0.dist-info/licenses/LICENSE,sha256=RjWhs6k8-dS1rdwUk40lp3R0kf8UVOrlASOO0FTDRnU,743
+security_controls_mcp-0.2.0.dist-info/licenses/LICENSE-DATA.md,sha256=I7iuA6E8TQyL3SMQltKFoOO12Ew2W0D8NSEmFAL5XDw,2096
+security_controls_mcp-0.2.0.dist-info/METADATA,sha256=GyLyzQtRf8rWlwSOP51YZOuUNRzaNWJyCjbGO5L6VnM,15823
+security_controls_mcp-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+security_controls_mcp-0.2.0.dist-info/entry_points.txt,sha256=pDgfu1FAwJGyGp2yGU4uhiLrt9Wy06uzTybWh7frYCs,59
+security_controls_mcp-0.2.0.dist-info/top_level.txt,sha256=BEEvk-ppPSeK1_OyEy0SIpt04wnf3nUorVOFU0fEmS0,22
+security_controls_mcp-0.2.0.dist-info/RECORD,,

security_controls_mcp-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

security_controls_mcp-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+scf-mcp = security_controls_mcp.cli:main

security_controls_mcp-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Ansvar Systems
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

security_controls_mcp-0.2.0.dist-info/licenses/LICENSE-DATA.md

@@ -0,0 +1,61 @@
+# Data License
+
+The SCF control data files in this repository (`scf-controls.json`, `framework-to-scf.json`) are licensed under:
+
+**Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)**
+
+**Copyright:** ComplianceForge
+**Source:** [Secure Controls Framework (SCF)](https://securecontrolsframework.com/)
+**Version:** SCF 2025.4 (Released December 29, 2025)
+
+---
+
+## License Summary
+
+You are free to:
+
+- **Share** — copy and redistribute the material in any medium or format for any purpose, even commercially
+
+Under the following terms:
+
+- **Attribution** — You must give appropriate credit to ComplianceForge, provide a link to the license, and indicate if changes were made
+- **NoDerivatives** — If you remix, transform, or build upon the material, you may not distribute the modified material
+
+---
+
+## ⚠️ Important: AI Derivative Content Restriction
+
+The SCF End User License Agreement specifically prohibits:
+
+> "utilizing Artificial Intelligence (AI) (or similar technologies) to leverage SCF content to generate policies, standards, procedures, metrics, risks, threats or other derivative content"
+
+This means you **may not** use AI systems (including Claude, ChatGPT, or similar) to generate derivative content based on SCF data.
+
+**Permitted Uses:**
+- Query and analyze control mappings
+- Map between frameworks
+- Reference controls in your work (with attribution)
+- Understand compliance requirements
+
+**Prohibited Uses:**
+- Asking AI to write policies/procedures based on SCF controls
+- Creating derivative frameworks for distribution
+- Generating automated compliance content using AI
+
+---
+
+## Full License
+
+The complete CC BY-ND 4.0 license is available at:
+https://creativecommons.org/licenses/by-nd/4.0/legalcode
+
+For SCF-specific terms and conditions, see:
+https://securecontrolsframework.com/terms-conditions/
+
+---
+
+## Questions?
+
+For questions about permitted uses, contact ComplianceForge directly or consult a legal professional.
+
+**This is not legal advice.** Consult qualified legal counsel for compliance guidance specific to your situation.

security_controls_mcp-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+security_controls_mcp