Back to Browse

Ventriloquist MCP Server

Developer ToolsUse Caution4.4MCP RegistryLocal
Free

Server data from the Official MCP Registry

Turn Mac apps into MCP tools via the accessibility API: no screenshots, no model per step.

About

Turn Mac apps into MCP tools via the accessibility API: no screenshots, no model per step.

Security Report

4.4
Use Caution4.4High Risk

Ventriloquist is a local macOS MCP server that replays recorded accessibility-API actions with no model calls during normal serve. Its main risk is the broad macOS Accessibility grant it requires, which the project documents as not being an OS-level boundary, and the model-calling and high-risk-tool paths are gated behind explicit opt-ins. The server's permissions match its stated purpose, and the visible code shows no exfiltration or malicious patterns, but the truncated files prevent a full review of subprocess usage and tool execution. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 0 high severity). Package verification found 1 issue.

4 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

accessibility_control

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

process_spawn

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

system_info

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Set to 1 to allow tools a pack marks as high risk. They are refused otherwise.Optional

Environment variable: VENT_ALLOW_HIGH

Set to 1 to let the server call a model to re-ground broken anchors. Off keeps serving model-free.Optional

Environment variable: VENT_HEAL

Directory for your own packs and traces. Defaults to ~/.ventriloquist.Optional

Environment variable: VENT_HOME

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-shaangs-ventriloquist": {
      "env": {
        "VENT_HEAL": "your-vent-heal-here",
        "VENT_HOME": "your-vent-home-here",
        "VENT_ALLOW_HIGH": "your-vent-allow-high-here"
      },
      "args": [
        "ventriloquist-mcp"
      ],
      "command": "uvx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!