Omega Brain MCP

OMEGA BRAIN MCP

Governance-First MCP Server — VERITAS Gates · Cryptographic Audit Ledger · Cortex Approval Pipeline



______________________________________________________________________

生态系统佳能

Omega Brain MCP是 VERITAS&主权生态系统（欧米茄宇宙）在其他存储层保存上下文的地方，Omega Brain会强制执行：每条执行路径都通过Cortex批准门，每个状态转换都密封到防篡改的SHA-3-256审计分类账，每个工件声明都必须在10门确定性构建管道中存活，然后才能发布判决。它不代表操作员做出信任决策，而是以加密方式毫无例外地强制执行操作员声明的约束。在Omega宇宙中，Omega Brain MCP是控制平面：代理自主性结束和声明策略开始的点。

系统不变性： VERITAS Build不能确定代码是否“良好”。VERITAS Build确定代码是否在明确声明的原语、约束、测试制度、边界、成本模型、证据和策略下，在有纪律的尝试中幸存下来。

______________________________________________________________________

目录

• 概述
• 特性
• 建筑
• 需求
• 安装
• 快速入门
• 配置
• 集成
• 用法示例
• 工具参考
• 资源
• CLAEG状态机
• 故障排除
• 安全与主权
• 威胁模型
• 路线图
• 欧米茄宇宙
• 许可证

______________________________________________________________________

概述

它是什么

Omega Brain MCP是一个自给自足的 模型上下文协议（MCP）服务器 它与任何兼容MCP的AI客户端一起作为本地进程运行。它公开了26个工具和9个资源，涵盖了四个治理领域：

• 跨会话情景记忆 --带全文搜索的SQLite保管库，在所有重启过程中都保持不变
• 10门VERITAS建造管道 --从INTAKE到TRACE/SEAL的确定性伪影评估
• 加密S.E.A.L.审计分类账 --仅附加SHA-3-256哈希链；每个操作都是密封的
• Cortex认证门 --三节点相似性门，在每次工具调用时强制执行声明的基线策略

两个Python文件。一个pip依赖。零外部服务。

兼容客户端：Claude Desktop、VS Code Copilot、Cursor、Windsurf、AutoGen、LangChain、CrewAI、LlamaIdex和任何符合MCP的主机。

它不是什么

• 不是云服务。 没有网络出口，没有API密钥，没有遥测。所有数据都保留在操作员的机器上 ~/.omega-brain/ （或 OMEGA_BRAIN_DATA_DIR).
• 不是语言模型。 Omega Brain不生成文本。它管理、路由、存储和审计代理操作。
• 不是政策权威。 VERITAS门执行操作员声明的内容。系统无法确定超出其证据和约束所描述的正确性。
• 不是防火墙或操作系统级隔离层。 看 威胁模型 明确的范围外边界。

______________________________________________________________________

特性

跨会话情景记忆

• 保险库（SQLite+FTS5） --会话、条目和事件在重新启动后仍然存在；启动时通过自动加载 omega://session/preload
• 语义RAG出处 --三层嵌入引擎： sentence-transformers → fastembed ONNX → TF-IDF n元语法；始终可用，无需GPU
• 密封交接 --SHA-256签名的跨会话内存文件；重启时自动加载，任务印章上自动写入

10号门VERITAS建造管道

完全确定性评估管道： 摄入→ TYPE → 依赖→ 证据→ MATH → COST → 激励→ 安全→ 对手→ 痕迹/密封

每个关卡都会返回一个结构化的判决(PASS, MODEL_BOUND, INCONCLUSIVE，或 VIOLATION).管道将最终结果密封为加密标识的记录。快速失败 VIOLATION 默认情况下。

加密审计分类账（S.E.A.L.）

• 仅附加SHA-3-256哈希链
• 每个Cortex检查、摄取、会话日志、门运行和执行都会自动密封
• 链的完整性在任何时候都是可验证的；任何被篡改的条目都会破坏链
• 坚持到 omega_ledger.json 在数据目录下

Cortex认证门

• 三节点相似门 根据操作员声明的基线提示评估每个工具调用
• 硬挡窗 =1.0.0；可选 fastembed 或 sentence-transformers 用于更高质量的嵌入
• 完全本地化 -无需云，无需API密钥，无需外部服务器

______________________________________________________________________

建筑

┌─────────────────────────────────────────────────────────────────┐
│                        MCP CLIENT                               │
│   (Claude Desktop / VS Code Copilot / Cursor / AutoGen / ...)   │
└───────────────────────────┬─────────────────────────────────────┘
                            │  MCP stdio / SSE (JSON-RPC 2.0)
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│                   OMEGA BRAIN MCP SERVER                        │
│               omega_brain_mcp_standalone.py                     │
│                                                                 │
│  ┌──────────────────────────┐  ┌──────────────────────────────┐ │
│  │       BRAIN CORE         │  │      VERITAS BUILD GATES     │ │
│  │                          │  │                              │ │
│  │  Cortex Approval Gate    │  │  10-Gate Pipeline            │ │
│  │  (Tri-Node, steer/block) │  │  INTAKE → TYPE → DEPENDENCY  │ │
│  │                          │  │  → EVIDENCE → MATH → COST    │ │
│  │  RAG Provenance Store    │  │  → INCENTIVE → SECURITY      │ │
│  │  (3-tier embeddings)     │  │  → ADVERSARY → TRACE/SEAL    │ │
│  │                          │  │                              │ │
│  │  S.E.A.L. Audit Ledger   │  │  Evidence Engine             │ │
│  │  (SHA-3-256 hash chain)  │  │  (Quality(e), MIS_GREEDY)    │ │
│  │                          │  │                              │ │
│  │  Sealed Handoff          │  │  CLAEG State Machine         │ │
│  │  (SHA-256 cross-session) │  │  NAFE Scanner                │ │
│  └──────────┬───────────────┘  └────────────────┬─────────────┘ │
└─────────────│──────────────────────────────────│───────────────┘
              │                                  │
              ▼  SQLite                          ▼  Pure Python
    ┌─────────────────────┐           ┌─────────────────────────┐
    │   ~/.omega-brain/   │           │  veritas_build_gates.py │
    │   omega_vault.db    │           │  (stateless, no I/O,    │
    │   omega_ledger.json │           │   reproducible verdicts)│
    │   omega_handoff.json│           └─────────────────────────┘
    └─────────────────────┘

组件角色

🏛️ 协议标准： 这 omega-brain-mcp 是官方的执行引擎 VERITASΩ-代码v2.0 规范。这里的结构门强制执行确定性声明，即power验证vault会话捕获、AEGIS修复和Sovereign工件。

判决制度

______________________________________________________________________

需求

嵌入发动机自动选择： 服务器探测 sentence-transformers 首先，然后 fastembed，然后回落到内置的TF-IDF n-gram。你总是会得到语义搜索——更丰富的模型可以提高回忆质量。

______________________________________________________________________

安装

来自PyPI

pip install omega-brain-mcp

源自

git clone https://github.com/VrtxOmega/omega-brain-mcp.git
cd omega-brain-mcp
pip install mcp
# Optional: better embeddings
pip install fastembed                       # recommended — fast ONNX, no GPU
pip install sentence-transformers numpy     # best quality, larger download

码头工人

docker build -t omega-brain-mcp .
docker run --rm -i omega-brain-mcp                              # stdio mode (MCP standard)
docker run --rm -p 8055:8055 omega-brain-mcp --sse --port 8055  # SSE mode

运行测试

pip install pytest pytest-asyncio pytest-cov
PYTHONUTF8=1 OMEGA_BRAIN_DATA_DIR=/tmp/omega-test pytest tests/ -v --tb=short

______________________________________________________________________

快速入门

1--验证服务器是否启动

python omega_brain_mcp_standalone.py --help

2--在stdio模式下运行（默认）

服务器从stdin读取JSON-RPC 2.0消息，并将响应写入stdout。MCP客户端通过以下配置自动管理此过程。

python omega_brain_mcp_standalone.py

3--在SSE模式下运行（HTTP流）

python omega_brain_mcp_standalone.py --sse --port 8055
# GET  http://localhost:8055/sse      — event stream
# POST http://localhost:8055/messages — send tool calls

4--手动测试工具调用（stdio）

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"omega_brain_status","arguments":{}}}' \
  | python omega_brain_mcp_standalone.py

5--配置MCP客户端（请参阅 配置)

______________________________________________________________________

配置

克劳德桌面版

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "omega-brain": {
      "command": "python",
      "args": ["/absolute/path/to/omega_brain_mcp_standalone.py"],
      "env": { "PYTHONUTF8": "1" }
    }
  }
}

VS代码/GitHub副本

添加 .vscode/mcp.json 在您的工作区（或用户设置）中：

{
  "servers": {
    "omega-brain": {
      "type": "stdio",
      "command": "python",
      "args": ["/absolute/path/to/omega_brain_mcp_standalone.py"],
      "env": { "PYTHONUTF8": "1" }
    }
  }
}

光标

在 光标设置→ MCP → 添加服务器:

{
  "mcpServers": {
    "omega-brain": {
      "command": "python",
      "args": ["/absolute/path/to/omega_brain_mcp_standalone.py"],
      "env": { "PYTHONUTF8": "1" }
    }
  }
}

风浪/瀑布

在 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "omega-brain": {
      "command": "python",
      "args": ["/absolute/path/to/omega_brain_mcp_standalone.py"],
      "env": { "PYTHONUTF8": "1" }
    }
  }
}

SSE/HTTP客户端

{
  "mcpServers": {
    "omega-brain": {
      "type": "sse",
      "url": "http://localhost:8055/sse"
    }
  }
}

环境变量

______________________________________________________________________

集成

Omega Brain MCP通过stdio或SSE使用标准JSON-RPC 2.0与任何兼容MCP的客户端集成。有关特定于框架的集成模式（LangChain、CrewAI、AutoGen、LlamaIdex），请参阅 INTEGRATIONS.md 和那个 examples/ 目录。

推荐的集成模式

对于生产使用，在所有调用中保留一个持久服务器进程。这避免了每次调用时加载嵌入模型和SQLite的2-3秒冷启动成本。

from omega_client import OmegaBrainClient

client = OmegaBrainClient()  # starts server subprocess once

# Governance-first: always run a Cortex check before executing
check = client.call("omega_cortex_check", {
    "tool": "omega_rag_query",
    "args": {"query": "sensitive project data"},
    "baseline_prompt": "You are a data analysis agent. Only access approved datasets."
})
# {"approved": true, "similarity": 0.71, "verdict": "APPROVED", "node_votes": [1, 1, 1]}

# Memory retrieval
result = client.call("omega_rag_query", {"query": "VERITAS evidence thresholds", "top_k": 5})

# Run VERITAS build gate pipeline
verdict = client.call("veritas_run_pipeline", {"claim": {...}, "regime": "baseline"})

# Session persistence — always seal before terminating
client.call("omega_seal_task", {})
client.close()

快速参考模式表

______________________________________________________________________

用法示例

所有示例都使用JSON-RPC 2.0。在实践中，当您调用工具时，MCP客户端会自动发送这些信息。壳体-内衬形式可用于测试。

检查服务器运行状况

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"omega_brain_status","arguments":{}}}' \
  | python omega_brain_mcp_standalone.py

回复（缩写）：

{
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"vault_sessions\": 3, \"vault_entries\": 42, \"rag_fragments\": 18, \"ledger_entries\": 127, \"embedding_engine\": \"fastembed\", \"omega_status\": \"OK\"}"
    }]
  }
}

Cortex认证检查

{
  "jsonrpc": "2.0", "id": 4,
  "method": "tools/call",
  "params": {
    "name": "omega_cortex_check",
    "arguments": {
      "tool": "omega_rag_query",
      "args": {"query": "sensitive user data"},
      "baseline_prompt": "You are a data analysis agent. Only access approved datasets."
    }
  }
}

答复：

{"approved": true, "similarity": 0.71, "verdict": "APPROVED", "node_votes": [1, 1, 1]}

运行整个VERITAS管道

{
  "jsonrpc": "2.0", "id": 5,
  "method": "tools/call",
  "params": {
    "name": "veritas_run_pipeline",
    "arguments": {
      "claim": {
        "claim_id": "claim-001",
        "artifact_type": "function",
        "description": "Validates user authentication tokens",
        "primitives": ["jwt", "hmac-sha256"],
        "evidence": [
          {
            "id": "e1", "type": "test_suite",
            "provenance": 0.9, "repeatability": 0.95,
            "freshness": 0.85, "env_match": 1.0
          }
        ],
        "constraints": [{"op": "lte", "left": "latency_ms", "right": 50}],
        "cost": {"cpu_p95": 0.3, "memory_gb_p95": 0.1},
        "security": {"sast_findings": [], "secrets_found": false}
      },
      "regime": "baseline"
    }
  }
}

答复：

{
  "verdict": "PASS",
  "gates_passed": 10,
  "seal_hash": "a3f9c2...",
  "pipeline_ms": 12,
  "omega_status": "OK"
}

NAFE扫描（检测AI叙事失败）

{
  "jsonrpc": "2.0", "id": 6,
  "method": "tools/call",
  "params": {
    "name": "veritas_nafe_scan",
    "arguments": {
      "text": "Although the tests failed, the developer clearly intended the function to work correctly, so we can assume it passes."
    }
  }
}

答复：

{
  "nafe_detected": true,
  "signatures": ["NARRATIVE_RESCUE", "INTENT_INFERENCE"],
  "seal_hash": "b7d1e4...",
  "omega_status": "NAFE_VIOLATION"
}

______________________________________________________________________

工具参考（26个工具）

大脑核心（12）

建造大门（15）

______________________________________________________________________

资源（9）

______________________________________________________________________

CLAEG状态机

INIT → { STABLE_CONTINUATION | ISOLATED_CONTAINMENT | TERMINAL_SHUTDOWN }
STABLE_CONTINUATION → { STABLE_CONTINUATION | ISOLATED_CONTAINMENT | TERMINAL_SHUTDOWN }
ISOLATED_CONTAINMENT → { STABLE_CONTINUATION | TERMINAL_SHUTDOWN }
TERMINAL_SHUTDOWN → {} (absorbing)

不变： 没有允许的过渡被视为 禁止. TERMINAL_SHUTDOWN 正在吸收——没有出口过渡。

______________________________________________________________________

文件结构

omega-brain-mcp/
├── omega_brain_mcp_standalone.py   # MCP server — Brain Core + tool dispatch (~1430 lines)
├── veritas_build_gates.py          # Gate engine — pure deterministic logic (~1430 lines)
├── omega_client.py                 # Python client helper (persistent process)
├── requirements.txt                # mcp>=1.0.0
├── pyproject.toml                  # Package config + optional deps
├── Dockerfile                      # Non-root, unbuffered, stdio + SSE
├── INTEGRATIONS.md                 # LangChain, CrewAI, AutoGen, LlamaIndex guides
├── SECURITY.md                     # Vulnerability reporting policy
├── CHANGELOG.md                    # Release history
├── docs/
│   └── integration.md              # Detailed integration reference
├── examples/
│   ├── langchain_quickstart.py
│   ├── crewai_quickstart.py
│   ├── autogen_quickstart.py
│   └── llamaindex_quickstart.py
└── tests/
    ├── test_build_gates.py         # Gate pipeline tests
    ├── test_veritas.py             # VERITAS scoring tests
    ├── test_seal.py                # SEAL chain integrity tests
    ├── test_handoff.py             # Handoff seal/context tests
    ├── test_cortex.py              # Cortex approval tests
    └── test_vault.py               # Vault persistence tests

______________________________________________________________________

故障排除

服务器未启动/ ModuleNotFoundError: mcp

pip install mcp

UnicodeDecodeError 在Windows上

运行前设置环境变量：

set PYTHONUTF8=1
python omega_brain_mcp_standalone.py

或添加 "env": { "PYTHONUTF8": "1" } 到您的MCP客户端配置。

客户端立即显示“服务器已断开连接”

1. 确认客户端配置中的路径为 绝对的 （例如。， C:\Users\you\omega-brain-mcp\omega_brain_mcp_standalone.py)，不是相对的。
2. 在终端中手动运行服务器以查看启动错误： python /path/to/omega_brain_mcp_standalone.py
3. 检查Python版本： python --version 必须为3.11+。

嵌入速度慢/质量低

安装更好的嵌入后端：

pip install fastembed          # fast, no GPU, ~30MB download — recommended
# or
pip install sentence-transformers numpy   # highest quality

服务器在启动时自动选择最佳可用引擎，并记录哪个层处于活动状态。

NAFE_VIOLATION 意外返回

NAFE扫描仪在传递给的文本中检测到叙事失败模式（救援框架、意图推理、道德凌驾或权威漂移） veritas_nafe_scan.查看 signatures 在响应字段中检测到特定模式，然后修改输入文本以陈述事实而无需叙事解释。

保险库/分类账损坏

删除数据目录并重新启动以从头开始重建（所有持久内存都将丢失）：

rm -rf ~/.omega-brain/
python omega_brain_mcp_standalone.py

要为每个项目使用单独的数据目录，请执行以下操作：

OMEGA_BRAIN_DATA_DIR=/path/to/project-brain python omega_brain_mcp_standalone.py

SSE模式： Connection refused 在端口8055上

确保服务器正在运行 --sse --port 8055 并且该端口未被防火墙阻止。请检查：

curl -N http://localhost:8055/sse

______________________________________________________________________

安全与主权

• 所有数据都是本地的。 保险库、S.E.A.L.分类账、RAG存储和移交文件存储在 ~/.omega-brain/ （或 OMEGA_BRAIN_DATA_DIR).没有数据传输到任何外部服务。
• 不需要API密钥。 服务器只需要本地Python安装和 mcp 包裹。
• 加密完整性。 S.E.A.L.分类账使用SHA-3-256哈希链；任何篡改过去记录的行为都会打破链条。交接文件是SHA-256密封的。
• 皮质块漂移。 Cortex门硬块工具调用相似之处如下 0.45 根据宣布的基线提示，防止快速注射使代理偏离其宣布的任务。
• NAFE护栏。 NAFE扫描仪在AI叙事失败传播之前检测并密封这些失败，包括试图通过道德框架或权威断言来推翻约束。
• 非root Docker。 提供的 Dockerfile 以非root身份运行 omega 用户。
• VERITAS门是无状态和确定性的。 veritas_build_gates.py 没有网络调用，没有文件I/O，也没有副作用。在相同的输入下，所有判决都是可重复的。
• 敏感数据处理。 不要将机密、凭据或PII摄入RAG存储或保管库。保险库是磁盘上未加密的SQLite；使用操作系统级文件权限保护它。

有关漏洞报告，请参阅 SECURITY.md.

______________________________________________________________________

威胁模型

范围内

超出范围

以下威胁是 不 由Omega Brain MCP解决：

• 主机或操作系统受损 --如果流程环境由对手控制，则没有足够的应用层保护
• 被盗或泄露的保险库加密密钥 --保险库是未加密的SQLite；操作系统级访问控制是操作员的责任
• 恶意管理员 --具有文件系统访问权限的操作员可以直接修改或删除数据目录
• 供应链妥协 mcp 或者Python本身 --依赖完整性验证是操作员的责任；使用锁文件和哈希验证
• 网络级攻击 --SSE模式公开HTTP端点；TLS终止和网络访问控制是运营商的责任
• 模型级越狱 --声明的工具调用上的Cortex门；它不控制语言模型的内部推理或响应

信任边界

  [ MCP Client / AI Agent ]
           │
           │  Trust: MCP client is the operator's declared agent.
           │         Baseline prompt defines the trust contract.
           ▼
  [ Omega Brain MCP Server ]  ← Enforcement boundary
           │
           │  Trust: Local filesystem is operator-controlled.
           │         No external services are contacted.
           ▼
  [ ~/.omega-brain/ (vault, ledger, handoff) ]

Cortex门是主要的信任执行点。所有工具调用都跨越了这一界限。VERITAS管道对人工制品声明执行循证政策。S.E.A.L.分类账提供了所有过境点的防篡改记录。

______________________________________________________________________

路线图

欢迎社区捐款。看 CONTRIBUTING.md 对于不能被破坏的不变量。

______________________________________________________________________

欧米茄宇宙

Omega Brain MCP是 VERITAS与主权生态系统以下存储库构成了更广泛的Omega宇宙：

______________________________________________________________________

📖 阅读主叙事： 为什么主权AI？

🌐 VERITAS Omega生态系统

该项目是 VERITAS欧米茄宇宙 --主权人工智能基础设施堆栈。

• VERITAS欧米茄代码 --确定性验证规范（10门管道）
• 重力欧米茄 --桌面AI操作平台
• 欧米茄 --适用于任何IDE的Ollama MCP桥
• OmegaWallet --桌面以太坊钱包（渲染器无法签名）
• veritas保险库 --本地第一AI知识引擎
• 主权拱廊 --8款游戏街机，采用VERITAS设计系统
• SSWP --确定性构建认证协议

许可证

麻省理工学院——见 LICENSE 全文。

______________________________________________________________________

Built by RJ Lopez · VERITAS Omega Framework

Report Issue · Changelog · Integrations · Security Policy · Glama MCP Registry