{"id":"vvkmnn-claude-praetorian-mcp","name":"claude-praetorian-mcp","homepage":"https://www.npmjs.com/package/claude-praetorian-mcp","repo_url":"https://github.com/Vvkmnn/claude-praetorian-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","claude-code","context-management","token-optimization","memory","compaction","offline","filesystem"],"what_it_does":"Provides an MCP server (Node/TypeScript, used via npx/claude mcp) for persisting and retrieving Claude Code context “compactions” as structured, incremental TOON snapshots stored locally under each project’s .claude/praetorian directory. Includes MCP tools/commands for compacting context (with dedup/merge via Jaccard title similarity) and restoring/searching relevant saved snapshots into the active context.","use_cases":["Reduce token usage in Claude Code by compacting web research outputs and task/subagent results into small structured snapshots","Fast resume of prior work by restoring relevant compactions via keyword query search","Maintain/refresh project-level “memory” of decisions, findings, and references without external databases","Proactive context compaction during long-running coding/research sessions (and via Claude Code hooks/skills/plugins)"],"not_for":["Sharing or hosting compactions as a centralized cloud service (it appears local/offline and project-scoped)","Scenarios requiring network-based search across many projects/accounts","Use where you cannot write to the filesystem or where local persistence is disallowed","Security-sensitive environments that require strict data retention controls without clear deletion/retention options"],"best_when":"You run Claude Code locally/within a controlled environment and want frequent, automated context compaction/reuse with minimal token spend while keeping everything project-scoped and offline.","avoid_when":"You need multi-tenant isolation, strict compliance guarantees, or you cannot persist data to <project>/.claude/praetorian on disk.","alternatives":["Generic context window summarizers (model-side only)","Other MCP servers for memory/context (vector DB-backed or file-based)","Manual snapshotting using notes/docs or existing Claude Code plugins without MCP persistence","Self-hosted search over prior logs using your own indexing toolchain"],"af_score":61.0,"security_score":32.0,"reliability_score":32.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:39:10.986616+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["TypeScript","Node.js"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No auth described; functionality appears local/offline and operates on project files via the MCP runtime (Claude Code configuration)."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing described; likely free as an npm package (MIT) with your own compute/token costs only."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local filesystem / project directory (.claude/praetorian)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":61.0,"security_score":32.0,"reliability_score":32.5,"mcp_server_quality":75.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":100.0,"rate_limit_clarity":10.0,"tls_enforcement":0.0,"auth_strength":20.0,"scope_granularity":10.0,"dependency_hygiene":60.0,"secret_handling":80.0,"security_notes":"Appears offline and stores flat files locally per project; no network calls or centralized service described. However, there is no explicit discussion of data retention/deletion, file permission hardening, input sanitization, or error/logging behavior. If content includes sensitive research/task outputs, it will be persisted to disk under .claude/praetorian without stated encryption at rest.","uptime_documented":0.0,"version_stability":50.0,"breaking_changes_history":40.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":"README describes merging/deduplication by >70% title similarity (Jaccard) when compacting, but it does not explicitly guarantee idempotent behavior for repeated identical tool calls.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Relies on project-scoped file storage under .claude/praetorian; ensure the working directory/project path is correct for the MCP server process.","If using npx, npm resolution may install an unexpected version/package unless pinned/forced.","No explicit rate-limit guidance (likely none since it’s local/file-based, but not documented).","Context restoration/search is keyword/index-based (inverted index) per README; for semantic matches you may need to structure titles/insights accordingly."]}}