Skip to main content

Crate ironcontext_core

Crate ironcontext_core 

Source
Expand description

IronContext — security & optimization engine for the Model Context Protocol.

ironcontext-core is the pure-CPU, offline-by-default library that powers the sentinel CLI, the Python wrapper and the GitHub Action. It exposes four cohesive subsystems:

  • manifest — strict deserializer for MCP initialize / tools/list payloads.
  • rules — May 2026 CVE pattern detectors (SEN-001 … SEN-010).
  • ris — the Reasoning-Impact Score (0..100 hallucination grade).
  • optimizer — heuristic description pruner + pluggable LLM trait.

Everything is glued together by report::Report / scan.

Re-exports§

pub use manifest::Manifest;
pub use manifest::Tool;
pub use optimizer::DescriptionOptimizer;
pub use optimizer::HeuristicOptimizer;
pub use optimizer::OptimizationOutcome;
pub use report::Report;
pub use report::ToolReport;
pub use ris::RisBreakdown;
pub use ris::RisScore;
pub use rules::Finding;
pub use rules::RuleId;
pub use rules::Severity;

Modules§

manifest
Strict deserializer for MCP manifests.
optimizer
Description token-pruning.
report
Top-level orchestrator: glue the parser, rule engine, RIS, and (optionally) the optimizer into one Report.
ris
Reasoning-Impact Score (RIS).
rules
May 2026 CVE pattern pack for MCP manifests.
sarif
Minimal SARIF 2.1.0 emitter.

Enums§

SentinelError
Errors surfaced by the library.

Functions§

optimize
Convenience: parse + run only the optimizer pass.
scan
Convenience: parse an MCP manifest from raw JSON bytes and produce a full report.