Parallels RAS MCP Server

A lightweight, read-only Model Context Protocol (MCP) server for querying Parallels Remote Application Server (RAS) infrastructure via the RAS REST API v20.

Gives AI assistants read-only visibility into your RAS environment — infrastructure, site settings, policies, publishing, sessions, and support — without making any changes.

Prerequisites

Node.js 18 or later
npm
Access to a Parallels RAS server with the REST API enabled (port 20443)

Installation

git clone https://github.com/RMITBLOG/ParallelsRAS_MCP.git
cd ParallelsRAS_MCP
npm install
npm run build

Environment Variables

Variable	Required	Default	Description
`RAS_HOST`	Yes	—	RAS server hostname or IP address
`RAS_USERNAME`	Yes	—	Administrator username
`RAS_PASSWORD`	Yes	—	Administrator password
`RAS_PORT`	No	`20443`	REST API port
`RAS_IGNORE_TLS`	No	`true`	Skip TLS certificate verification (for self-signed certs)

Configuration

Claude Desktop

Edit your claude_desktop_config.json (typically at %APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "parallels-ras": {
      "command": "node",
      "args": ["/path/to/RAS_MCP/build/index.js"],
      "env": {
        "RAS_HOST": "ras-server.example.com",
        "RAS_USERNAME": "administrator",
        "RAS_PASSWORD": "your-password",
        "RAS_PORT": "20443",
        "RAS_IGNORE_TLS": "true"
      }
    }
  }
}

Claude Code

Add the MCP server to your project or global settings:

claude mcp add parallels-ras -- node /path/to/RAS_MCP/build/index.js

Set environment variables in your shell or in the Claude Code MCP configuration.

Cursor

In Cursor settings, go to Features > MCP Servers and add a new server:

Name: parallels-ras
Command: node /path/to/RAS_MCP/build/index.js
Environment Variables:
- RAS_HOST = ras-server.example.com
- RAS_USERNAME = administrator
- RAS_PASSWORD = your-password

OpenAI-Compatible Clients

For clients supporting the MCP standard via stdio transport, configure the server command as:

node /path/to/RAS_MCP/build/index.js

With the required environment variables (RAS_HOST, RAS_USERNAME, RAS_PASSWORD) set in the client's MCP server configuration.

Available Tools (41 total)

All tools are read-only and annotated with readOnlyHint: true for automatic approval in compatible clients.

Infrastructure (14 tools)

Tool	Description
`ras_infra_get_agents`	List all RAS agents and their status
`ras_infra_get_connection_brokers`	Connection broker status and priority
`ras_infra_get_providers`	Cloud/hypervisor providers (AVD, AWS, Azure, Hyper-V, etc.)
`ras_infra_get_rds_hosts`	RDS session hosts
`ras_infra_get_rds_hostpools`	RDS host pools
`ras_infra_get_certificates`	Certificate inventory
`ras_infra_get_halb_status`	HALB device status
`ras_infra_get_enrollment_status`	Enrollment server status
`ras_infra_get_vdi_hostpools`	VDI host pools
`ras_infra_get_vdi_templates`	VDI templates
`ras_infra_get_gateway_status`	Secure Client Gateway status
`ras_infra_get_sites`	Farm sites and their status
`ras_infra_get_saml_idps`	SAML identity providers for SSO
`ras_infra_get_themes`	User portal themes and branding

Site Settings (10 tools)

Tool	Description
`ras_site_get_ad_integration`	Active Directory integration config
`ras_site_get_connection_settings`	Connection and authentication settings
`ras_site_get_fslogix`	FSLogix profile container config
`ras_site_get_load_balancing`	Load balancing settings
`ras_site_get_mfa`	MFA provider configuration
`ras_site_get_printing`	Printing settings
`ras_site_get_tenant_broker`	Tenant broker status
`ras_site_get_notifications`	Notification event configuration
`ras_site_get_url_redirection`	URL redirection rules
`ras_site_get_cpu_optimization`	CPU optimization settings

Policies (1 tool)

Tool	Description
`ras_policies_list`	List all client policies

Farm Settings (7 tools)

Tool	Description
`ras_farm_get_administrators`	Admin accounts and roles
`ras_farm_get_config`	Farm configuration
`ras_farm_get_licensing`	Licensing status and seat usage
`ras_farm_get_version`	Web service version
`ras_farm_get_performance`	Performance monitor configuration
`ras_farm_get_mailbox`	SMTP mailbox settings
`ras_farm_get_reporting`	Reporting configuration

Publishing (7 tools)

Tool	Description
`ras_pub_get_rds_apps`	Published RDS applications
`ras_pub_get_vdi_apps`	Published VDI applications
`ras_pub_get_avd_apps`	Published AVD applications
`ras_pub_get_desktops`	Published desktops
`ras_pub_get_folders`	Resource folders
`ras_pub_get_status`	Publishing service status
`ras_pub_get_all_items`	All published items (combined view)

RD Sessions (1 tool)

Tool	Description
`ras_sessions_list`	Active remote desktop sessions

Help & Support (1 tool)

Tool	Description
`ras_support_info`	Support information

Extending

To add a new tool module:

Create a new file in src/tools/ (e.g., notifications.ts)
Export a register(server: McpServer): void function
Use rasClient.get("/api/...") to call RAS endpoints
Import and call your register function in src/index.ts
Rebuild: npm run build

See existing tool files for the pattern.

License

MIT

Parallels RAS MCP Server

Parallels RAS MCP Server

Prerequisites

Installation

Environment Variables

Configuration

Claude Desktop

Claude Code

Cursor

OpenAI-Compatible Clients

Available Tools (41 total)

Infrastructure (14 tools)

Site Settings (10 tools)

Policies (1 tool)

Farm Settings (7 tools)

Publishing (7 tools)

RD Sessions (1 tool)

Help & Support (1 tool)

Extending

License

Reviews