jev-cognitive-mcp
English · 简体中文
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 |
Core Modules & MCP Tools
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, orBLOCK). - Layer 0 (
reflex_only=trueor 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): Evaluatesis_destructive,is_rce_or_exfil, andis_secret_leakprobabilities viaJevBridge.
- Evaluates shell commands before execution and returns an advisory action (
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). Recommendshuman_gateon irreversible high-risk actions. Works completely offline.
- Purely deterministic calculation of expected escalation utility from
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), orDEEP_REASONING(o3,codex-1) tiers while estimating architectural scope.
- Classifies incoming coding prompts into
jev_verify(jev_kit.verifier) — Caller-Supplied Completion & Acceptance Review- Reviews caller-supplied
task_spec,implemented_changessummary, andtest_resultslogs to returnPASS,ADVISORY, orNEEDS_REVISION. Does not inspect git repositories or run test suites directly.
- Reviews caller-supplied
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_guardwithreflex_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
JevBridgeRuntime:jev_guard(whenreflex_only=falseand Layer 0 does not match),jev_route,jev_verify, andjev_rerankinvokejev_cli.pyfrom the localJevBridgeruntime directory.- Set
JEV_BRIDGE_DIR=/path/to/JevBridge/runtime(defaults to%LOCALAPPDATA%\JevBridge\runtimeon Windows or~/.local/share/JevBridge/runtimeon Linux/macOS). If the bridge runtime is not installed, these tools fail closed withJevIntegrationError(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()andcall_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 raiseSENSITIVE_INPUT_REJECTEDbefore_invoke_bridge()can be called. - Zero Direct Credential Arguments:
call_jev()rejects explicitapi_key,token, orsecretkeyword arguments (DIRECT_CREDENTIALS_DISABLED). - Advisory Boundary: Outputs from
jev-cognitive-mcpare 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 raiseJevIntegrationErrorwith explicitbilling_uncertaintracking rather than defaulting toALLOWorPASS.
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
DevToolsActivePortDiscovery: 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/terraform.tfstate/ ChromeLocal Statefile uploads inDOM.setFileInputFiles, blocksdocument.cookie/cookieStore.getAll(),localStorage/sessionStorage/indexedDBnetwork exfiltration,navigator.clipboard.readText(), andnavigator.credentials.get()harvesting inRuntime.evaluate, blocks bulkDOMStorage/IndexedDB/cookie dumps, MITMFetch.enable/Network.setCookieoverrides, sensitiveBrowser.setDownloadBehaviorpath traversal, andCookie/Proxy-Authorizationheader overrides, blocksfile://browser profile vault reads and cloud metadata SSRF (169.254.169.254,[fd00:ec2::254],100.100.100.200) inPage.navigate, and enforcesuserGesture: trueon 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 (75-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 |
Metadata
Release files for jev-cognitive-mcp 0.4.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| jev_cognitive_mcp-0.4.4.tar.gz | 38.7 kB | With provenance | Details for jev_cognitive_mcp-0.4.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| jev_cognitive_mcp-0.4.4-py3-none-any.whl | Python 3 | none | any | Details for jev_cognitive_mcp-0.4.4-py3-none-any.whl |
Total release size: 77.4 kB
Release files / jev_cognitive_mcp-0.4.4.tar.gz
| Download URL | jev_cognitive_mcp-0.4.4.tar.gz |
|---|---|
| Size | 38.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c4b4a57b26fc811ed82fdeea97dce11b6a76ffed00c5d402c5ef3c41a1618e3b
|
|
BLAKE2b-256 checksum How to use checksums |
537c9827148f092090866e244407b5c3e5b45a365190d165e3b19b514aa03f12
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logRelease files / jev_cognitive_mcp-0.4.4-py3-none-any.whl
| Download URL | jev_cognitive_mcp-0.4.4-py3-none-any.whl |
|---|---|
| Size | 38.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e1005773f7965fbcebd38486dbde800c1526589ce3cab9763f689c89dfaaf968
|
|
BLAKE2b-256 checksum How to use checksums |
e0131ad005ae2a73415e928044852cf6b1dfb6272f7a85facd7e218053a14bec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logSecurity for jev-cognitive-mcp 0.4.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for jev_cognitive_mcp-0.4.4.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.