Oferece observabilidade local-first para egress de IA, registrando destinos de chamadas de saída, processos, tamanhos e tempo de execução.
Também conhecido como vantioai/vantio-open-core, vantio-optics, @vantio/optics-mcp
- Stars
- 2
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 0.1.2
- Último commit
- 13 de nov. de 2026
- Licença
- —
O que é o MCP Vantio Optics?
Vantio Optics é um MCP server. Oferece observabilidade local-first para egress de IA, registrando destinos de chamadas de saída, processos, tamanhos e tempo de execução.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Vantio Optics
O Vantio Optics oferece observabilidade local-first para egress de IA, com foco no monitoramento de atividade de rede de saída. Ele foi projetado para desenvolvedores e usuários preocupados com segurança que precisam rastrear para onde suas aplicações de IA estão enviando dados. O sistema registra detalhes específicos, incluindo o destino, o processo envolvido, o tamanho dos dados e o tempo de execução das chamadas de saída. Diferente de ferramentas de enforcement, este nível gratuito não bloqueia ações nem retém dados sensíveis de prompts e completions.
Os usuários podem implementar isso via @vantio/cli no macOS, Linux ou Windows WSL, ou usando o Python SDK com o decorador @shield. Para ambientes Node.js, a ferramenta utiliza um interceptor Node injetado via comando vantio run para cobrir protocolos como fetch, WebSocket e http/https. Esta configuração não exige conta ou chaves de API para funcionar. O servidor pode exportar eventos registrados através de OTLP/HTTP JSON, syslog, JSON lines ou webhooks, facilitando a integração com stacks de monitoramento existentes.
O que você pode fazer com ele
- 1Monitorar tráfego de IA de saídaRastreie o destino e o tamanho de cada chamada de saída feita por um processo em execução.
- 2Auditar conexões de redeIdentifique quais processos e conexões estão sendo registrados atualmente no seu sistema.
- 3Detectar novos destinos de redeSinalize instâncias onde um programa se conecta a um destino que não está na sua allowlist local.
- 4Exportar dados de telemetriaEnvie eventos de egress registrados para serviços de monitoramento externos usando webhooks ou syslog.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Vantio Optics
Formatos verificados em 10 nov 2026Instalar o MCP Vantio Optics no Claude Code
$ claude mcp add vantio-optics -- npx -y @vantio/optics-mcpInstalar o MCP Vantio Optics no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vantio-optics": {
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Instalar o MCP Vantio Optics no VS Code
.vscode/mcp.json
{
"servers": {
"vantio-optics": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Instalar o MCP Vantio Optics no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"vantio-optics": {
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Instalar o MCP Vantio Optics no Codex
~/.codex/config.toml
[mcp_servers.vantio-optics] command = "npx" args = ["-y", "@vantio/optics-mcp"]
Instalar o MCP Vantio Optics no Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"vantio-optics": {
"command": "npx",
"args": [
"-y",
"@vantio/optics-mcp"
]
}
}
}Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelvantioai/vantio-open-core is public and reachablegithub.com/vantioai/vantio-open-core ↗Passou
- O pacote cita este repositório como fonte@vantio/optics-mcp names vantioai/vantio-open-core as sourcenpmjs.com/package/@vantio/optics-mcp ↗Passou
- Proveniência da build (atestação Sigstore)No build attestation published for this releaseNão verificado
- Licença de código aberto (OSI)No licenseProblema encontrado
- Commit ou release no último anoLast commit or release 2026-11-13github.com/vantioai/vantio-open-core ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @vantio/optics-mcpPassou
- Nenhum alerta crítico no pacote ou nas dependências99 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP Vantio Optics
Como adiciono o MCP Vantio Optics ao Claude Code?
Execute claude mcp add vantio-optics -- npx -y @vantio/optics-mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Vantio Optics ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
O Vantio Optics bloqueia chamadas de IA de saída?
Não, o Optics é uma ferramenta de observabilidade de apenas leitura que registra dados, mas não bloqueia ações nem retém prompts ou completions.
Preciso de uma conta ou chave de API para usar a versão gratuita?
A versão gratuita do Optics não requer conta nem chave de API.
Como posso exportar os dados de eventos registrados?
Você pode usar o comando export para enviar eventos como OTLP/HTTP JSON, syslog, JSON lines ou via webhook.
A telemetria vem habilitada por padrão?
Não, a telemetria vem desabilitada por padrão, a menos que você opte explicitamente por ativá-la usando a variável de ambiente VANTIO_TELEMETRY=1.