Vantio Optics

Name: Vantio Optics
Author: vantioai

本地服务

vantio.ai安全24 天前更新

代码仓库访问官网

关于 Vantio Optics

Vantio Optics 是本地优先的 AI 出站网络活动观测工具，适用于监控 Agent 出站流量的团队。它记录目标地址、进程、数据量和时间，不会阻止调用，也不保留提示词或回复。

主要功能

01记录出站目标地址和进程
02采集调用数据量与时间
03查看已记录的进程和连接覆盖情况
04标记不在本地允许列表中的目标
05通过多种格式导出事件

适用场景

01查看 AI 进程访问的目标地址
02检查已记录的进程和连接
03识别允许列表之外的首次访问目标
04向监控系统导出网络事件

MCP 相关

README 将 `@vantio/optics-mcp` 列为 Optics 的安装方式之一，但未说明其向客户端提供哪些工具或资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vantioai-vantio-optics": {
      "command": "npx",
      "args": [
        "-y",
        "@vantio/optics-mcp"
      ]
    }
  }
}

启动命令npx -y @vantio/optics-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@vantio/optics-mcp0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	integer	否	要返回的最大运行次数（默认值为 20）

详细介绍

Vantio

面向 AI 的 Linux 安全。

此存储库包含 Vantio Optics、Phantom Engine 安装程序和 Python SDK。

Vantio Optics（开放核心）

免费、本地优先的 AI 出站流量可观测性。Optics 是免费的 Observe 层。它会记录受支持的出站调用的目标、进程、大小和时间。不阻止操作，也不保留提示词或补全内容。

Optics 主页正在迁移至 github.com/vantioai/vantio-optics。发布仍通过此存储库进行。编辑器扩展仍位于 extensions/vantio-optics。命令和本地安装说明请参见 extensions/vantio-optics/README.md。

安装

以下是 npm 和 PyPI 于 2026-10-21 提供的版本。此 git 树中的清单可能比注册表中的版本更新。

包	注册表	版本
`@vantio/cli`	npm	0.3.24
`@vantio/agent-sdk`	npm	0.2.4
`vantio-agent-sdk`	PyPI	3.1.1
`@vantio/optics-mcp`	npm	0.1.2
`@vantio/gate-mcp`	npm	0.1.0

@vantio/gate-mcp 是用于较早集成的兼容性包。

Optics CLI，适用于 macOS、Linux 和 Windows（WSL）：

npm install -g @vantio/[email protected]
vantio run node agent.js

vantio run 会使用 NODE_OPTIONS --require 为 node、npx、tsx 和 ts-node 注入 Node 拦截器。在 Node 上，它可覆盖 fetch、undici、http/https、http2、net/tls、WebSocket，以及启动的 curl 或 wget。

Python SDK：

pip install vantio-agent-sdk==3.1.1

使用 @shield 封装 Python 可调用对象。仅在命令前加上 vantio run python 本身不会进行拦截。

Node SDK：

npm install @vantio/[email protected]

Node SDK 提供 shield()。Node 出站流量的覆盖由 vantio run 提供。

Optics MCP：

npm install @vantio/[email protected]

免费版 Optics 无需账户或 API 密钥。

浏览器路径不在此封装范围内。

如果进程打开了 Node 拦截器无法监测的套接字、在 vantio run 之外启动了子进程，或使用了未配备 Python SDK 的非 Node 运行时，就可能无法被封装。Optics 会记录它封装的路径。

vantio coverage 会输出此系统上记录的进程和连接，并指出其中哪些路径位于本地允许列表中。vantio destinations 会标记记录到的程序首次连接到不在该列表中的目标的情况。vantio export 会将这些事件作为 OTLP/HTTP JSON、syslog 或 JSON 行，或通过 Webhook 发送。Optics 不会阻止调用。

遥测默认处于禁用状态。设置 VANTIO_TELEMETRY=1 即表示选择启用。VANTIO_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1 会覆盖此启用设置。

Phantom Engine 安装程序

Phantom Engine 为已注册的 Linux 系统提供强制执行和控制功能。请联系 Vantio。产品页面：vantio.ai/phantom-engine。

安装程序源代码位于 packages/vantio-install。vantio-install 不在 npm 或 PyPI 上。操作员安装使用 packages/vantio-install/docs/QUICKSTART.md 中介绍的密封 wheel。命令为 vantio-install 和 vantio-verify。此安装不会替换 @vantio/cli。该包中的安装说明面向 x86_64 上的 Ubuntu 24.04 LTS。

文档

网站：vantio.ai
文档：vantio.ai/docs
Optics：vantio.ai/optics
Phantom Engine：vantio.ai/phantom-engine
CLI：packages/vantio-cli/README.md
Python SDK：packages/vantio-agent-sdk-py/README.md
编辑器扩展：extensions/vantio-optics/README.md

许可证

@vantio/cli、@vantio/agent-sdk 和 vantio-agent-sdk 声明采用 MIT 许可证。CLI 和 Python SDK 的许可证文件分别为 packages/vantio-cli/LICENSE 和 packages/vantio-agent-sdk-py/LICENSE。Node SDK 在 packages/vantio-agent-sdk/package.json 中声明采用 MIT 许可证。根目录下没有 LICENSE 文件。MIT 许可授予适用于此处列出的已发布软件包。