Proporciona observabilidad local para el egreso de IA mediante el registro de destinos de llamadas salientes, procesos, tamaños y tiempos.
También conocido como vantioai/vantio-open-core, vantio-optics, @vantio/optics-mcp
- Stars
- 2
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.2
- Último commit
- 13 nov 2026
- Licencia
- —
¿Qué es Vantio Optics MCP?
Vantio Optics es un MCP server. Proporciona observabilidad local para el egreso de IA mediante el registro de destinos de llamadas salientes, procesos, tamaños y tiempos.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Vantio Optics
Vantio Optics ofrece observabilidad local para el egreso de IA, centrándose en el monitoreo de la actividad de red saliente. Está diseñado para desarrolladores y usuarios preocupados por la seguridad que necesitan rastrear hacia dónde envían datos sus aplicaciones de IA. El sistema registra detalles específicos que incluyen el destino, el proceso involucrado, el tamaño de los datos y el tiempo de las llamadas salientes. A diferencia de las herramientas de cumplimiento, este nivel gratuito no bloquea acciones ni retiene datos sensibles de prompts y completions.
Los usuarios pueden implementarlo a través de @vantio/cli en macOS, Linux o Windows WSL, o utilizando el SDK de Python con el decorador @shield. Para entornos Node.js, la herramienta utiliza un interceptor de Node inyectado mediante el comando vantio run para cubrir protocolos como fetch, WebSocket y http/https. Esta configuración no requiere cuentas ni API keys para funcionar. El servidor puede exportar los eventos registrados a través de OTLP/HTTP JSON, syslog, JSON lines o webhooks, lo que facilita la integración con stacks de monitoreo existentes.
Qué puedes hacer con él
- 1Monitorear el tráfico de IA salienteRastrea el destino y el tamaño de cada llamada saliente realizada por un proceso en ejecución.
- 2Auditar conexiones de redIdentifica qué procesos y conexiones se están registrando actualmente en tu sistema.
- 3Detectar nuevos destinos de redSeñala instancias donde un programa se conecta a un destino que no está en tu lista de permitidos local.
- 4Exportar datos de telemetríaEnvía eventos de egreso registrados a servicios de monitoreo externos usando webhooks o syslog.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Vantio Optics MCP
Formatos verificados el 10 nov 2026Instalar Vantio Optics MCP en Claude Code
$ claude mcp add vantio-optics -- npx -y @vantio/optics-mcpInstalar Vantio Optics MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vantio-optics": {
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Instalar Vantio Optics MCP en VS Code
.vscode/mcp.json
{
"servers": {
"vantio-optics": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Instalar Vantio Optics MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"vantio-optics": {
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Instalar Vantio Optics MCP en Codex
~/.codex/config.toml
[mcp_servers.vantio-optics] command = "npx" args = ["-y", "@vantio/optics-mcp"]
Instalar Vantio Optics MCP en Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"vantio-optics": {
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblevantioai/vantio-open-core is public and reachablegithub.com/vantioai/vantio-open-core ↗Aprobado
- El paquete cita este repositorio como fuente@vantio/optics-mcp names vantioai/vantio-open-core as sourcenpmjs.com/package/@vantio/optics-mcp ↗Aprobado
- Procedencia de la compilación (atestación Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/vantioai/vantio-open-core ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @vantio/optics-mcpAprobado
- Sin avisos críticos en el paquete ni en sus dependencias99 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake MCPNo verificado
README
Ver en GitHubVantio
Linux security for AI.
This repository contains Vantio Optics, the Phantom Engine installer, and the Python SDK.
Vantio Optics (Open Core)
Free, local-first observability for AI egress. Optics is the free Observe tier. It records the destination, the process, the size, and the timing of a supported outbound call. Does not block actions or retain prompts or completions.
The Optics home is moving to github.com/vantioai/vantio-optics. Publishing still runs from this repository. The editor extension stays at extensions/vantio-optics. Commands and local install notes are in extensions/vantio-optics/README.md.
Install
These are the versions npm and PyPI served on 2026-10-21. Manifests in this git tree can be newer than the registry.
| Package | Registry | Version |
|---|---|---|
@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 is a compatibility package for an older integration.
Optics CLI, on macOS, Linux, and Windows (WSL):
npm install -g @vantio/cli@0.3.24
vantio run node agent.js
vantio run injects the Node interceptor with NODE_OPTIONS --require for node, npx, tsx, and ts-node. On Node it covers fetch, undici, http/https, http2, net/tls, WebSocket, and spawned curl or wget.
Python SDK:
pip install vantio-agent-sdk==3.1.1
Wrap a Python callable with @shield. Prefixing vantio run python does not intercept by itself.
Node SDK:
npm install @vantio/agent-sdk@0.2.4
The Node SDK exposes shield(). Outbound Node coverage comes from vantio run.
Optics MCP:
npm install @vantio/optics-mcp@0.1.2
Free Optics needs no account and no API key.
Browser paths stay outside this wrap.
A process can miss the wrapper when it opens a socket the Node interceptor does not see, starts a subprocess outside vantio run, or uses a runtime other than Node without the Python SDK. Optics records the paths it wrapped.
vantio coverage prints the processes and connections recorded on this system, and which of those paths are on a local allowlist. vantio destinations flags the first time a recorded program connects to a destination that is not on that list. vantio export sends those events as OTLP/HTTP JSON, syslog or JSON lines, or a webhook. Optics does not stop the call.
Telemetry is disabled by default. Set VANTIO_TELEMETRY=1 to opt in. VANTIO_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 override that opt-in.
Phantom Engine installer
Phantom Engine is enforcement and control for enrolled Linux systems. Contact Vantio. The product page is vantio.ai/phantom-engine.
The installer source is packages/vantio-install. vantio-install is not on npm or PyPI. Operator install uses the sealed wheel described in packages/vantio-install/docs/QUICKSTART.md. The commands are vantio-install and vantio-verify. That install does not replace @vantio/cli. The installer notes in that package target Ubuntu 24.04 LTS on x86_64.
Documentation
- Site: vantio.ai
- Docs: 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
- Editor extension: extensions/vantio-optics/README.md
License
@vantio/cli, @vantio/agent-sdk, and vantio-agent-sdk declare MIT. License files for the CLI and the Python SDK are packages/vantio-cli/LICENSE and packages/vantio-agent-sdk-py/LICENSE. The Node SDK declares MIT in packages/vantio-agent-sdk/package.json. There is no root LICENSE file. The MIT grant covers the published packages named here.
Security
Report a suspected vulnerability to security@vantio.ai. The process is SECURITY.md.
Contributing
See CONTRIBUTING.md and CODE_OF_CONDUCT.md.
Preguntas sobre Vantio Optics MCP
¿Cómo agrego Vantio Optics MCP a Claude Code?
Ejecuta claude mcp add vantio-optics -- npx -y @vantio/optics-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Vantio Optics MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Vantio Optics bloquea las llamadas de IA salientes?
No, Optics es una herramienta de observabilidad de solo lectura que registra datos, pero no bloquea acciones ni retiene prompts o completions.
¿Necesito una cuenta o una API key para usar la versión gratuita?
La versión gratuita de Optics no requiere cuenta ni API key.
¿Cómo puedo exportar los datos de eventos registrados?
Puedes usar el comando export para enviar eventos como OTLP/HTTP JSON, syslog, JSON lines o a través de un webhook.
¿La telemetría está activada por defecto?
No, la telemetría está desactivada por defecto a menos que optes por activarla explícitamente usando la variable de entorno VANTIO_TELEMETRY=1.