# Vytrix

> Vytrix is an open-source MCP server for developer tools. Read-only host activity, history, anomalies and evidence from a Vytrix collector. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Repository:** https://github.com/zyvorai/zyvor-vytrix
- **MCP Registry name:** io.github.zyvorai/vytrix
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

This MCP server is a read-only window onto Vytrix, a system activity monitor for macOS and Linux. Vytrix groups processes by application, shows listening ports tied to their project folders, and tracks Docker and Podman containers, fed by a single-file Python collector with no dependencies. The MCP server lets an assistant query that collector for current activity, history, anomalies and evidence.

It runs from an OCI image over stdio and needs two settings: VYTRIX_URL, the collector's base URL, and VYTRIX_TOKEN, its bearer token, which is read from the environment and never printed. Plain HTTP is accepted only for localhost, and inside a container 127.0.0.1 refers to the container itself, so the URL should be set explicitly.

The collector exposes only reads: snapshot and history endpoints behind a bearer token, plus a health check, and it never kills, signals or changes anything. History is kept in a local SQLite file for 30 days. A native Mac app, a browser dashboard with simulated demo telemetry and an optional read-only Mac cluster view are part of the wider project.

## Features

- **Host activity queries:** Ask what a machine is doing right now.
- **History and anomalies:** Review past readings and unusual ranges with evidence.
- **Read-only by design:** The collector never kills, signals or changes anything.
- **Token authentication:** Uses a bearer token read only from the environment.
- **Container awareness:** Underlying collector covers Docker and Podman containers.
- **30-day history:** Local SQLite history with 30-day retention.

## Good for

- Asking which application is using the CPU
- Finding what is listening on a port and which project owns it
- Reviewing an anomaly with supporting evidence
- Checking a remote host without an agent suite

## Install

### Claude Code (Terminal)

```sh
claude mcp add vytrix --env VYTRIX_URL='<VYTRIX_URL>' --env VYTRIX_TOKEN='<VYTRIX_TOKEN>' -- docker run -i --rm -e VYTRIX_URL -e VYTRIX_TOKEN ghcr.io/zyvorai/vytrix-mcp:0.8.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vytrix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VYTRIX_URL",
        "-e",
        "VYTRIX_TOKEN",
        "ghcr.io/zyvorai/vytrix-mcp:0.8.0"
      ],
      "env": {
        "VYTRIX_URL": "<VYTRIX_URL>",
        "VYTRIX_TOKEN": "<VYTRIX_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vytrix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VYTRIX_URL",
        "-e",
        "VYTRIX_TOKEN",
        "ghcr.io/zyvorai/vytrix-mcp:0.8.0"
      ],
      "env": {
        "VYTRIX_URL": "<VYTRIX_URL>",
        "VYTRIX_TOKEN": "<VYTRIX_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vytrix": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VYTRIX_URL",
        "-e",
        "VYTRIX_TOKEN",
        "ghcr.io/zyvorai/vytrix-mcp:0.8.0"
      ],
      "env": {
        "VYTRIX_URL": "<VYTRIX_URL>",
        "VYTRIX_TOKEN": "<VYTRIX_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vytrix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VYTRIX_URL",
        "-e",
        "VYTRIX_TOKEN",
        "ghcr.io/zyvorai/vytrix-mcp:0.8.0"
      ],
      "env": {
        "VYTRIX_URL": "<VYTRIX_URL>",
        "VYTRIX_TOKEN": "<VYTRIX_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vytrix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VYTRIX_URL",
        "-e",
        "VYTRIX_TOKEN",
        "ghcr.io/zyvorai/vytrix-mcp:0.8.0"
      ],
      "env": {
        "VYTRIX_URL": "<VYTRIX_URL>",
        "VYTRIX_TOKEN": "<VYTRIX_TOKEN>"
      }
    }
  }
}
```

## FAQ

### What do I need to run it?

A Vytrix collector, its URL as VYTRIX_URL and its bearer token as VYTRIX_TOKEN.

### Can it change anything on the host?

No. The collector is read-only.

### Can I use plain HTTP?

Only for localhost.

### How long is history kept?

The collector keeps 30 days by default.

### Is Vytrix free?

Yes. Vytrix is open source, so you can use and self-host it for free.

### How do I add Vytrix to Claude Code?

Run this command in your terminal: claude mcp add vytrix --env VYTRIX_URL='<VYTRIX_URL>' --env VYTRIX_TOKEN='<VYTRIX_TOKEN>' -- docker run -i --rm -e VYTRIX_URL -e VYTRIX_TOKEN ghcr.io/zyvorai/vytrix-mcp:0.8.0

### What are the best alternatives to Vytrix?

The closest alternatives to Vytrix are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/vytrix
