Skip to main content
Glama

jev-cognitive-mcp

English · 简体中文

CI License: MIT Python 3.10+ MCP Protocol

Advisory 3+1 Cognitive Hierarchy Toolkit & Model Context Protocol (MCP) Server for Coding Agents (OpenAI Codex CLI, Claude Code, Cursor, Antigravity).

jev-cognitive-mcp provides deterministic Layer-0 DLP/destructive command pre-screening, 5-factor Meta-Controller escalation arbitration, and optional System-1 probabilistic triage (guard, route, verify, rerank) over stdio MCP. All verdicts and routing signals are advisory—the host agent remains responsible for enforcing command blocking, sandboxing, and human-in-the-loop approval gates.


Architecture: The 3+1 Cognitive Hierarchy

flowchart LR
    A["Incoming Agent Action / Task"] --> L0["Layer 0: Deterministic Reflex<br/>(0 network / 0 token cost)<br/>DLP regex & destructive pattern screen"]
    L0 -->|Blocked / Matched| OUT0["Immediate Advisory Verdict"]
    L0 -->|Needs Semantic Triage| S1["System 1: Probabilistic Intuition (JEV)<br/>(Requires external JevBridge)<br/>Guard / Route / Rerank / Verify"]
    S1 --> MC{"Meta-Controller<br/>5-Factor Arbitration"}
    MC -->|High Confidence & Two-Way Door| OUT1["Advisory Fast Path"]
    MC -->|Low Confidence / High Risk| S2["System 2: Host Frontier LLM<br/>(Codex / o3 / Sonnet Thinking)"]
    MC -->|One-Way Door & High Risk| HG["Explicit Human Gate Required"]

Layer

Role

Execution Mode

Responsibility

Layer 0 (Reflex)

Deterministic Code

Local offline (0 tokens, no network call)

Pre-egress regex DLP credential screening (sk-*, sk-ant-*, ghp_*, glpat-*, AKIA*, SG.*, pypi-*, hf_*, Bearer, password=, secret=, api_key=, token=, PEM keys), destructive shell pattern matching (rm -rf /, rm -rf -- /, Remove-Item -Recurse -Force, mkfs, wipefs -a, shred -u /, DROP DATABASE, curl | bash), strict schema validation

System 1 (Intuition)

Probabilistic JEV

External JevBridge single-attempt call

Multi-head noul (boolean probability), choice (categorical distribution), and score (0..4 ordinal rubric) evaluations

System 2 (Reasoning)

Host Frontier LLM

Host agent runtime

Complex causal reasoning, multi-file architecture design, subtle debugging

Meta-Controller

Control Plane

Local offline (0 tokens, no network call)

Arbitrates escalation using 5 quantitative signals: Confidence, Risk, Reversibility, Expected Value, and Cost Pressure


Related MCP server: ToolBastion

Core Modules & MCP Tools

  1. jev_guard (jev_kit.guard) — Advisory Pre-Tool Command Risk Screen

    • Evaluates shell commands before execution and returns an advisory action (ALLOW, INSPECT, ESCALATE_HUMAN, or BLOCK).

    • Layer 0 (reflex_only=true or pre-screen): Blocks literal credential egress (SENSITIVE_INPUT_REJECTED) and known destructive shell/PowerShell patterns locally with zero network calls.

    • System 1 (when reflex_only=false): Evaluates is_destructive, is_rce_or_exfil, and is_secret_leak probabilities via JevBridge.

  2. jev_arbitrate (jev_kit.controller) — Offline 5-Factor Meta-Controller

    • Purely deterministic calculation of expected escalation utility from (confidence, risk, reversible, expected_value, cost_pressure). Recommends human_gate on irreversible high-risk actions. Works completely offline.

  3. jev_route (jev_kit.router) — Advisory Task & Model Tier Router

    • Classifies incoming coding prompts into FAST (codex-mini-latest, gpt-4o-mini), STANDARD (gpt-4.1, gpt-4o), or DEEP_REASONING (o3, codex-1) tiers while estimating architectural scope.

  4. jev_verify (jev_kit.verifier) — Caller-Supplied Completion & Acceptance Review

    • Reviews caller-supplied task_spec, implemented_changes summary, and test_results logs to return PASS, ADVISORY, or NEEDS_REVISION. Does not inspect git repositories or run test suites directly.

  5. jev_rerank (jev_kit.reranker) — Bounded Semantic Candidate Reranker

    • Ranks up to 96 caller-supplied code snippets or issue candidates in deterministic batches of 12 while preserving full provenance and failing closed on partial batch errors.


Offline Deterministic Mode vs. External JevBridge Requirement

  • Works 100% Offline (Zero External Dependencies):

    • jev_arbitrate (5-factor Meta-Controller)

    • jev_guard with reflex_only=true (jev-kit guard "<cmd>" --reflex-only)

    • jev-kit init-codex (configuration generator for OpenAI Codex CLI and MCP clients)

    • Pre-egress credential DLP screening inside call_jev() (blocks sensitive tokens before any bridge lookup)

  • Requires External JevBridge Runtime:

    • jev_guard (when reflex_only=false and Layer 0 does not match), jev_route, jev_verify, and jev_rerank invoke jev_cli.py from the local JevBridge runtime directory.

    • Set JEV_BRIDGE_DIR=/path/to/JevBridge/runtime (defaults to %LOCALAPPDATA%\JevBridge\runtime on Windows or ~/.local/share/JevBridge/runtime on Linux/macOS). If the bridge runtime is not installed, these tools fail closed with JevIntegrationError(code="BRIDGE_MISSING").


Quick Start

1. Installation

git clone https://github.com/17671454333/jev-cognitive-mcp.git
cd jev-cognitive-mcp
pip install -e ".[dev]"

2. Wire into OpenAI Codex CLI (~/.codex/config.toml)

Generate the exact TOML snippet with jev-kit init-codex --format toml and add it to ~/.codex/config.toml:

[mcp_servers.jev_cognitive]
command = "jev-mcp"
args = []

3. Wire into JSON MCP Clients (Claude Code, Cursor, Antigravity)

Generate with jev-kit init-codex --format json:

{
  "mcpServers": {
    "jev-cognitive": {
      "command": "jev-mcp",
      "args": []
    }
  }
}

4. CLI Usage & Verification

# Generate OpenAI Codex CLI config.toml snippet
jev-kit init-codex --format toml

# Layer-0 deterministic reflex screen (offline, 0 tokens)
jev-kit guard "rm -rf -- /" --reflex-only

# 5-factor Meta-Controller arbitration (offline, 0 tokens)
jev-kit arbitrate --confidence 0.62 --risk 0.75 --irreversible --value 0.85

# Run deterministic unit test suite
python -m unittest discover -s tests -v

Security & Reliability Boundaries

  • Pre-Egress Credential DLP Chokepoint: Both local_reflex_screen() and call_jev() screen serialized inputs for literal secrets (sk-*, ghp_*, glpat-*, AKIA*, sntrys_*, s.*, PMAK-*, glsa_*, Bearer, password=, secret=, api_key=, token=, PEM private keys, and URL userinfo credentials) and raise SENSITIVE_INPUT_REJECTED before _invoke_bridge() can be called.

  • Zero Direct Credential Arguments: call_jev() rejects explicit api_key, token, or secret keyword arguments (DIRECT_CREDENTIALS_DISABLED).

  • Advisory Boundary: Outputs from jev-cognitive-mcp are advisory structured signals; host agents must enforce execution blocking and human approval gates.

  • No Silent Fallbacks: Timeouts, missing bridge runtimes (BRIDGE_MISSING), or malformed responses raise JevIntegrationError with explicit billing_uncertain tracking rather than defaulting to ALLOW or PASS.

License

Released under the MIT License.

Zero-Popup Chrome M144+ Live CDP Guard (jev_chrome_guard)

Modern Chrome (M144+) exposes %LOCALAPPDATA%\Google\Chrome\User Data\DevToolsActivePort via chrome://inspect/#remote-debugging, triggering a native modal prompt on every transient WebSocket handshake. jev_chrome_guard provides:

  • Zero-Popup DevToolsActivePort Discovery: Parses live port and browser WebSocket UUID across Windows, macOS, and Linux without opening transient WebSockets.

  • Layer-0 CDP DLP & SSRF Pre-Screen: Blocks accidental .env / SSH key / .kube/config / .aws/credentials / .docker/config.json / terraform.tfstate / Chrome Local State file uploads in DOM.setFileInputFiles, blocks document.cookie / cookieStore.getAll(), localStorage/sessionStorage/indexedDB/caches.open() network exfiltration, navigator.clipboard.readText(), navigator.credentials.get() harvesting, File System Access API (showDirectoryPicker / navigator.storage.getDirectory), and persistent navigator.serviceWorker.register() injection across both Runtime.evaluate and Runtime.callFunctionOn, blocks bulk DOMStorage/IndexedDB/CacheStorage/cookie dumps, silent Browser.grantPermissions / Page.setBypassCSP overrides, persistent Page.addScriptToEvaluateOnNewDocument / Runtime.addBinding backdoors, TLS downgrade (Security.setIgnoreCertificateErrors), MITM Fetch.enable / Network.setCookie overrides, sensitive Browser.setDownloadBehavior path traversal, and Cookie/Proxy-Authorization header overrides, blocks javascript: pseudo-URLs, file:// browser profile vault reads, and cloud metadata SSRF (169.254.169.254, [fd00:ec2::254], [::ffff:169.254.169.254], 100.100.100.200) across Page.navigate and Target.createTarget, and enforces userGesture: true on safe evaluations to prevent popup blockers.


Open-Core Pro & Commercial Ecosystem

Capability

Community Core (jev-cognitive-mcp · MIT)

Studio Pro Suite (Commercial / Sponsors)

Layer-0 Shell & CDP Guardrails

✅ Included (85-case JSONL benchmark, 0 tokens)

✅ + Custom Enterprise Policy Packs

5-Factor Meta-Controller & Autopilot

✅ Included (jev_arbitrate, jev_autopilot)

✅ + Multi-Key Quota Balancer

Chrome M144+ Zero-Popup CDP Guard

✅ Endpoint Discovery + Layer-0 CDP Screen

✅ + Persistent Multi-Tab Daemon & Windows UIA Auto-Consent

8-Platform Matrix Auto-Publisher

—

🚀 Pro Exclusive: One-click zero-login publishing to YouTube, TikTok, Bilibili, Xiaohongshu, Douyin, WeChat Channels & Kuaishou

AI Short-Drama & WebGame Studio

See open-short-drama-studio

🚀 Pro Exclusive: Cross-shot face-locking, Seedance 85%-credit-saver pipeline, CapCut draft exporter & 6-target WebGame packager

Available Tools

8 tools
jev_arbitrateB

Run the offline deterministic 5-factor Meta-Controller to recommend Layer-0 Reflex, System-1 Intuition, System-2 Deep Reasoning, or Human Gate.

Inputs: risk (required), confidence (required), reversible (required), cost_pressure, +3 more.

jev_autopilotB

Zero-config offline autopilot selector that recommends model tier, reasoning_effort (low/medium/high), and context tier without manual grouping.

Inputs: task_description (required), context_chars.

jev_benchmarkA

Run the offline deterministic Layer-0 JSONL replay benchmark suite and return accuracy and timing metrics.

Inputs: input_path.

jev_chrome_guardC

Zero-popup Chrome M144+ DevToolsActivePort discovery and Layer-0 DLP/SSRF pre-screening for live browser CDP automation.

Inputs: method, params, target_url, custom_port_file.

jev_guardA

Provide advisory risk screening for a shell command using Layer-0 deterministic regex rules and (unless reflex_only=true) System-1 probabilistic evaluation. Does not intercept host execution.

Inputs: command (required), context, reflex_only.

jev_rerankA

Rank up to 96 candidate text items against a query in batches of 12 (requires JevBridge runtime).

Inputs: items (required), query (required), top_k.

jev_routeB

Provide advisory task complexity and model tier recommendation (requires configured JevBridge runtime).

Inputs: task_description (required), context.

jev_verifyB

Review caller-supplied task specification, change summary, and test logs for potential evidence gaps (does not run tests or read git diffs directly; requires JevBridge runtime).

Inputs: task_spec (required), implemented_changes (required), test_results.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 8 tools

    Disambiguation3/5

    The tools are mostly distinct, but jev_autopilot, jev_route, and jev_arbitrate all relate to model/reasoning selection and could be confused. Their descriptions differentiate offline vs. runtime and tier vs. reasoning mode, but an agent may still misselect among them.

    Naming Consistency4/5

    All tool names use a consistent jev_ snake_case prefix, making them easy to recognize as a set. However, some names are verbs (verify, rerank, route) while others are nouns or compound nouns (autopilot, chrome_guard, benchmark), so the verb_noun pattern is not strict.

    Tool Count5/5

    Eight tools is a well-scoped count for this cognitive/advisory toolkit. Each tool has a distinct high-level function, and there is no obvious filler or redundancy.

    Completeness4/5

    The surface covers benchmarking, routing, arbitration, guarding, verification, and reranking, which appears complete for the stated advisory domain. Minor gaps exist around runtime status/configuration checks and explicit cognitive state management, but agents can likely work around them.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A zero-trust security gateway for MCP tool calls, inspecting tool identity, arguments, execution decisions, and returned content before risk reaches your coding agent.
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Provides advisory AI-governance checks for MCP hosts and coding agents, enabling policy verdicts, PII masking, and audit traces before executing tool calls.
      3
      82 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to make structured local decisions, choose bounded browser actions with approvals, and run coding workflows such as file relevance, context pruning, diff screening, and completion checks through MCP or CLI.
      Apache 2.0