DEVELOPER INFRASTRUCTURE · MCP SPECIFICATION

构建在确定性执行底座之上

Nexus 是面向开发者的通用 MCP 执行基础设施（Execution Infrastructure），而不是聊天机器人。提供标准 Model Context Protocol 网关、自定义 Provider 扩展、JobObject 容器隔离与可编程式 Action Ledger 访问。

Execution ≠ Success=true. Evidence certifies reality.

Universal MCP Gateway

在本地 127.0.0.1:18080/mcp 提供标准 SSE 与 HTTP JSON-RPC 2.0 端点。自动向 ChatGPT、Claude 与 Cursor 广播已注册工具及参数模式。

ENDPOINT: /mcp · TRANSPORT: SSE / stdio / HTTP

Tool Registry

采用强类型模式规范（JSON Schema Draft 7）。每一个工具均带有自描述风险评级（Safe / Caution / Dangerous）与参数边界。

VALIDATION: AJV · STRICT: true · TYPING: TypeScript

Custom Provider API

支持第三方开发拓展。无论将本地硬件板卡、CAD 建模软件或是私有企业数据库接入 AI，只需实现统一的 Provider 接口。

INTERFACE: INexusProvider · EXTENSIBLE: Yes

Runner (JobObject Isolation)

Windows JobObject 物理进程池硬隔离。保证子进程生命周期严格受控，杜绝内存泄漏、僵尸进程与失控死循环。

QUOTA: Memory & CPU · TIMEOUT: CancelToken

Verification Hooks

在工具动作返回后，自动触发后置断言钩子。查询 OS 底层验证磁盘文件字节数、SHA-256 签名与窗口状态，签发凭据包。

ASSERTIONS: File / Process / Window / DOM

Action Ledger Logs

提供本地 REST API 与 WebSocket 实时流式读取 Action Ledger 日志。支持按照 Action ID、工具名或时间戳执行离线法证分析。

FORMAT: JSON WAL · STREAM: WebSocket /sse

SDK Code Examples

开发者集成代码范例

TypeScript / Node.js SDK

通过官方 SDK 连接本地执行桥接并执行带断言的工具调用：

import { NexusClient } from "@nexus/sdk";

const client = new NexusClient({
  endpoint: "http://127.0.0.1:18080",
  token: process.env.NEXUS_CLIENT_TOKEN,
  verifyWorldState: true,
});

// 执行带二次验证的受控文件写入
const result = await client.execute({
  tool: "filesystem.write",
  parameters: {
    path: "workspace/output/report.docx",
    content: bufferData,
  },
  idempotencyToken: "TASK-8921-CHUNK-01"
});

console.log("Action ID:", result.actionId);
console.log("Verified:", result.verification.pass);
console.log("SHA-256 Digest:", result.worldState.sha256);

Python SDK (Autonomous Agent Harness)

在自主 Agent 框架（如 LangChain / AutoGen / CrewAI）中挂载 Nexus 执行底座：

from nexus import NexusHarness

harness = NexusHarness(
    endpoint="http://127.0.0.1:18080",
    client_token=os.getenv("NEXUS_TOKEN")
)

# 动态拉取当前物理工作站支持的所有标准工具契约
tools = harness.get_mcp_tools()

# 将执行交给 Nexus，获取真实物理状态证据
evidence = harness.invoke(
    tool_name="application.launch",
    arguments={"executable": "blender.exe", "args": ["--background"]}
)

assert evidence.verified is True
print(f"Blender HWND: {evidence.world_state['hwnd']}")