AI代理可视化界面工具

graph LR
    A[AI Agent] <-->|MCP Protocol| B[MCPViews]
    B <-->|Plugin System| C[Plugin MCP Servers]
    B -->|Rich Display| D[Companion Window]
    D -->|User Actions| B

    style A fill:#6366f1,stroke:#4f46e5,color:#fff
    style B fill:#1e1b4b,stroke:#6366f1,color:#fff
    style C fill:#6366f1,stroke:#4f46e5,color:#fff
    style D fill:#4f46e5,stroke:#3730a3,color:#fff

{
  "mcpServers": {
    "mcpviews": {
      "type": "url",
      "url": "http://localhost:4200/mcp"
    }
  }
}

{
  "mcpServers": {
    "mcpviews": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:4200/mcp"]
    }
  }
}

> Call the mcpviews_setup tool to configure MCPViews for this agent.

> Call list_registry to see available plugins.
> Call mcpviews_install_plugin with trigger_auth: true to install and authenticate in one step.

# Rust (user-local)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
. "$HOME/.cargo/env"

# Node 20.19+ (user-local)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
export NVM_DIR="$HOME/.nvm"
. "$NVM_DIR/nvm.sh"
nvm install 20.19.0
nvm use 20.19.0

# Ubuntu 24.04 / Debian:
sudo apt install -y \
  pkg-config libssl-dev \
  libwebkit2gtk-4.1-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev patchelf

# Fedora:
sudo dnf install webkit2gtk4.1-devel libappindicator-gtk3-devel librsvg2-devel openssl-devel pkgconf-pkg-config

# Arch:
sudo pacman -S webkit2gtk-4.1 libappindicator-gtk3 librsvg openssl pkgconf

git clone https://github.com/DeeJanuz/mcpviews.git
cd mcpviews
npm install
npm run build

# Install dependencies
npm install

# Dev mode (hot reload frontend + Rust backend)
npm run dev

# Build frontend only
npm run build:frontend

# Build Rust backend only (from src-tauri/)
cargo build

# Build full Tauri app (frontend + backend + installer)
npm run build

# Build a macOS dev app/dmg with local sibling plugins bundled
npm run build:mac-dev-bundle

# Health check
curl http://localhost:4200/health

# Push rich content
curl -X POST http://localhost:4200/api/push \
  -H 'Content-Type: application/json' \
  -d '{"toolName":"rich_content","result":{"data":{"title":"Test","body":"## Hello\n\nThis is a test."}}}'

# Push with review (returns immediately with session_id; call await_review to wait for decision)
curl -X POST http://localhost:4200/api/push \
  -H 'Content-Type: application/json' \
  -d '{"toolName":"structured_data","result":{"data":{"title":"Review Changes","tables":[{"id":"changes","name":"Changes","columns":[{"id":"target","name":"Target","change":null},{"id":"summary","name":"Summary","change":"update"}],"rows":[{"id":"change-1","cells":{"target":{"value":"Introduction section","change":null},"summary":{"value":"Replace intro text","change":"update"}},"children":[]}]}]}},"reviewRequired":true}'

# Build
cd sidecar && bash build.sh

# Run
node sidecar/dist/sse-bridge.mjs --app-host https://app.example.com --key lf_companion_xxx

mcpviews/
├── bundled-plugins/        # Bundled/example plugin manifests
│   └── tribex-ai/          # Hosted workspace compatibility manifest
├── src-tauri/              # Rust backend
│   ├── src/
│   │   ├── main.rs         # Tauri entry, tray, plugin setup
│   │   ├── http_server.rs  # axum HTTP server (:4200)
│   │   ├── session.rs      # In-memory session store
│   │   ├── review.rs       # Pending review channels (oneshot)
│   │   ├── commands.rs     # Tauri IPC commands
│   │   └── state.rs        # Shared app state
│   ├── Cargo.toml
│   └── tauri.conf.json
├── src/                    # Frontend (Vite entry)
│   ├── index.html          # HTML shell + workspace navigation frame
│   └── styles.css          # Shared app styles and workspace shell layout
├── public/                 # Static assets (copied to dist)
│   ├── main.js             # App bootstrap (Tauri IPC)
│   └── renderers/          # Built-in content renderers + hosted AI provider surfaces
├── sidecar/                # Node.js SSE bridge
│   ├── sse-bridge.ts
│   └── build.sh
├── registry/               # Plugin registry
│   └── registry.json       # Default registry with available plugins
├── cli/                    # CLI plugin manager
│   └── src/main.rs
├── shared/                 # Shared types (manifest, auth, registry)
│   └── src/lib.rs
├── package.json
└── vite.config.ts

# Search the registry
mcpviews-cli plugin search

# Install a plugin from the registry
mcpviews-cli plugin add decidr

# List installed plugins
mcpviews-cli plugin list

# Install from a local manifest file
mcpviews-cli plugin add-custom ./my-plugin.json

# Remove a plugin
mcpviews-cli plugin remove decidr

{
  "name": "my-plugin",
  "version": "1.0.0",
  "renderers": {
    "tool_name": "renderer_name"
  },
  "mcp": {
    "url": "http://localhost:8080/mcp",
    "auth": {
      "type": "bearer",
      "token_env": "MY_API_KEY"
    },
    "tool_prefix": "myplugin_"
  }
}