Skip to main content
Glama
Parallels RAS MCP Server

Parallels RAS MCP Server

by RMITBLOG

Parallels RAS MCP 服务器

一个由社区维护的、只读的 Model Context Protocol (MCP) 服务器,用于通过 RAS REST API 查询 Parallels Remote Application Server (RAS) 基础设施。

它让 AI 助手能够查看您的 RAS 环境(基础设施、站点设置、策略、发布和会话),而无需进行任何更改。

不隶属于 Parallels International GmbH。“Parallels”是其各自所有者的商标。

范围和预期用途

支持两种传输方式,通过 MCP_TRANSPORT 环境变量进行选择:

  • stdio(默认)—— 由 MCP 客户端(Claude Desktop、Claude Code、Cursor 等)作为本地子进程启动。适用于个人管理员在其工作站上使用,或用于开发和测试环境。凭据来自启动进程的环境;没有网络监听器。

  • http —— 带有必需 Bearer Token 的可流式 HTTP 监听器。适用于受信任的网络部署,其中一个服务器由多个客户端共享(例如,在添加 TLS 的反向代理后面)。默认绑定 127.0.0.1:3000;绑定到所有接口需要手动开启。

无论哪种模式,该服务器都会保持一个 RAS 管理员会话并公开 41 个只读工具。它不公开写入或破坏性工具,也不提供多租户或速率限制——请将其视为管理员级别的服务并相应地保护访问权限。

API 兼容性: 已针对 Parallels RAS v21 REST API 进行验证。所使用的资源在 v18–v21 之间保持稳定。

Related MCP server: Dell SC Series MCP Server

先决条件

  • Node.js 18 或更高版本

  • npm

  • 能够访问启用了 REST API 的 Parallels RAS 服务器(默认端口 20443)

安装

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

环境变量

连接到 RAS

变量

必需

默认

描述

RAS_HOST

是

—

RAS 服务器主机名或 IP 地址

RAS_USERNAME

是

—

管理员用户名

RAS_PASSWORD

是

—

管理员密码

RAS_PORT

否

20443

REST API 端口

RAS_IGNORE_TLS

否

true

跳过 TLS 证书验证(用于自签名证书)

传输

变量

必需

默认

描述

MCP_TRANSPORT

否

stdio

stdio 或 http

MCP_HTTP_BEARER_TOKEN

仅 HTTP

—

客户端必须在 Authorization: Bearer … 中提供的 Bearer Token。没有它服务器将拒绝启动。使用 openssl rand -hex 32 生成。

MCP_HTTP_HOST

否

127.0.0.1

绑定地址。设置为 0.0.0.0 以在所有接口上公开(前端使用 TLS 终止)。

MCP_HTTP_PORT

否

3000

监听端口。

配置

以下示例涵盖了 stdio 传输,这是默认设置,也是大多数用户所需要的。对于 HTTP 传输,请参阅下方的 通过 HTTP 运行。

Claude Desktop

编辑您的 claude_desktop_config.json(Windows 上通常位于 %APPDATA%\Claude\claude_desktop_config.json,macOS 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "parallels-ras": {
      "command": "node",
      "args": ["/path/to/ParallelsRAS_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

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

在您的 shell 或 Claude Code MCP 配置中设置环境变量。

Cursor

在 Cursor 设置中,转到 Features → MCP Servers 并添加:

  • Name: parallels-ras

  • Command: node /path/to/ParallelsRAS_MCP/build/index.js

  • Environment: RAS_HOST, RAS_USERNAME, RAS_PASSWORD

其他支持 MCP 的客户端

对于任何支持通过 stdio 使用 MCP 的客户端,请将其指向:

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

并在客户端的 MCP 服务器配置中设置所需的环境变量。

通过 HTTP 运行

HTTP 传输实现了 MCP Streamable HTTP 并作为长期运行的进程执行。当您希望在受信任的网络上由多个客户端共享一个服务器时使用它——通常位于终止 TLS 的反向代理后面。

启动服务器

export RAS_HOST=ras-server.example.com
export RAS_USERNAME=administrator
export RAS_PASSWORD=your-password
export MCP_TRANSPORT=http
export MCP_HTTP_BEARER_TOKEN=$(openssl rand -hex 32)   # required
# export MCP_HTTP_HOST=127.0.0.1                       # default; set 0.0.0.0 to expose
# export MCP_HTTP_PORT=3000

npm run start:http

服务器在启动时会记录监听地址。MCP 端点是 POST /mcp。请求必须包含 Authorization: Bearer <MCP_HTTP_BEARER_TOKEN>;缺少或错误的 Token 将返回 401。

连接客户端

对于支持可流式 HTTP MCP 服务器的客户端,请将其指向 http://<host>:<port>/mcp 并在 Authorization 标头中包含 Bearer Token。例如,Claude Code CLI:

claude mcp add parallels-ras --transport http \
  --header "Authorization: Bearer $MCP_HTTP_BEARER_TOKEN" \
  http://your-server:3000/mcp

生产环境检查清单

  • 始终在前端使用 TLS —— 使用反向代理(nginx、Caddy、Traefik)终止 HTTPS,MCP 服务器绑定到 127.0.0.1 且仅通过代理访问。

  • 将 MCP_HTTP_BEARER_TOKEN 视为凭据 —— 至少 32 字节的熵,存储在密钥管理器中,并在员工离职时轮换。

  • 限制网络可达性(防火墙、VPN、私有子网)。Bearer 检查是服务器本身唯一的身份验证层。

  • RAS 管理员凭据与监听器位于同一主机上 —— 任何拥有该主机 shell 访问权限的人都可以读取它们。不要在多租户机器上运行此程序。

可用工具(共 41 个)

所有工具均为只读,并标注了 readOnlyHint: true 以便在兼容客户端中自动批准。

基础设施 (14)

工具

描述

ras_infra_get_agents

列出所有 RAS 代理及其状态

ras_infra_get_connection_brokers

连接代理状态和优先级

ras_infra_get_providers

云/虚拟机管理程序提供商 (AVD, AWS, Azure, Hyper-V 等)

ras_infra_get_rds_hosts

RDS 会话主机

ras_infra_get_rds_hostpools

RDS 主机池

ras_infra_get_certificates

证书清单

ras_infra_get_halb_status

HALB 设备状态

ras_infra_get_enrollment_status

注册服务器状态

ras_infra_get_vdi_hostpools

VDI 主机池

ras_infra_get_vdi_templates

VDI 模板

ras_infra_get_gateway_status

安全客户端网关状态

ras_infra_get_sites

农场站点及其状态

ras_infra_get_saml_idps

用于 SSO 的 SAML 身份提供商

ras_infra_get_themes

用户门户主题和品牌

站点设置 (9)

工具

描述

ras_site_get_ad_integration

Active Directory 集成配置

ras_site_get_connection_settings

连接和身份验证设置

ras_site_get_load_balancing

负载均衡设置

ras_site_get_mfa

MFA 提供商配置

ras_site_get_printing

打印设置

ras_site_get_tenant_broker

租户代理状态

ras_site_get_notifications

通知事件配置

ras_site_get_url_redirection

URL 重定向规则

ras_site_get_cpu_optimization

CPU 优化设置

FSLogix 未通过 REST API 在站点范围内公开 —— 它是按主机池/按 AVD 模板配置的,或通过 PowerShell 配置。

策略 (1)

工具

描述

ras_policies_list

列出所有客户端策略

农场设置 (7)

工具

描述

ras_farm_get_administrators

管理员账户和角色

ras_farm_get_config

农场配置

ras_farm_get_licensing

许可状态和席位使用情况

ras_farm_get_version

Web 服务版本

ras_farm_get_performance

性能监控配置

ras_farm_get_mailbox

SMTP 邮箱设置

ras_farm_get_reporting

报告配置

发布 (9)

工具

描述

ras_pub_get_rds_apps

已发布的 RDS 应用程序

ras_pub_get_vdi_apps

已发布的 VDI 应用程序

ras_pub_get_avd_apps

已发布的 AVD 应用程序

ras_pub_get_rds_desktops

已发布的 RDS 桌面

ras_pub_get_vdi_desktops

已发布的 VDI 桌面

ras_pub_get_avd_desktops

已发布的 AVD 桌面

ras_pub_get_folders

资源文件夹

ras_pub_get_status

发布服务状态

ras_pub_get_all_items

所有已发布项目(组合视图)

RD 会话 (1)

工具

描述

ras_sessions_list

活动远程桌面会话

扩展

要添加新工具:

  1. 在 src/tools/ 中创建或打开一个文件(例如 notifications.ts)。

  2. 导出一个 register(server: McpServer): void 函数。

  3. 使用官方 RAS REST API 中存在的路径调用 rasClient.get("/api/<Resource>")。

  4. 在 src/index.ts 中导入并调用您的 register 函数。

  5. 运行 npm run build。

模块文件名(infrastructure.ts、site-settings.ts 等)是相关工具的内部归组。它们不对应 URL 段 —— 真正的 RAS API 在 /api/<PascalCaseResource> 下是扁平的(例如 /api/Agent、/api/License、/api/MFA)。

API 参考

路线图

  • 写入操作 —— 超出本仓库的范围。任何修改 RAS 状态的工具都应由单独的服务器托管,以便此处的只读工具可以安全地自动批准。

  • HTTP 传输的 OAuth / OIDC —— 目前是单个共享的 Bearer Token。基于用户的身份将允许多个客户端共享一个部署而无需共享凭据。

贡献

欢迎提交问题和拉取请求。对于小修复以外的任何内容,请先开一个 issue,以便我们就方法达成一致。

历史

  • v1.1.0 —— 除了现有的 stdio 传输外,增加了可选的、带有 Bearer Token 身份验证的可流式 HTTP 传输。

  • v1.0.1 —— 根据 Parallels RAS v21 REST API 更正了所有 41 个工具路径,并添加了针对捆绑 OpenAPI 规范的构建时路径验证器 (scripts/verify-verify-tool-paths.mjs)。

  • v1.0.0 —— 草稿脚手架;REST API 路径是根据文档目录标题而非实际端点建模的。已被 v1.0.1 取代。

许可证

MIT

Available Tools

43 tools
ras_docs_get_pageGet Parallels Documentation PageA
Read-onlyIdempotent

Fetch the full markdown content of a specific Parallels documentation page. Use after ras_docs_search when you need the complete page (prerequisites, full procedure, all options) rather than excerpts. Accepts a full https://docs.parallels.com/... URL.

Inputs: url (required).

ras_farm_get_administratorsFarm AdministratorsA
Read-onlyIdempotent

List RAS farm administrator accounts — usernames, roles, permissions, group membership. Use this to audit admin access, verify role assignments, or review who has administrative control of the farm.

Inputs: limit, fields, filter.

ras_farm_get_configFarm ConfigurationA
Read-onlyIdempotent

RAS farm configuration settings — farm name, domain, backup settings, global options. Use this to review the overall farm setup, verify domain configuration, or check backup scheduling.

Inputs: no named parameters.

ras_farm_get_licensingLicensingA
Read-onlyIdempotent

RAS licensing status — license type (subscription/perpetual), expiration date, seat count, usage, activation status. Use this to check compliance, verify capacity, or diagnose licensing issues.

Inputs: no named parameters.

ras_farm_get_mailboxMailbox SettingsA
Read-onlyIdempotent

SMTP mailbox configuration used for RAS email notifications — server address, port, sender details. Use this to verify email notification settings or troubleshoot delivery failures.

Inputs: no named parameters.

ras_farm_get_performancePerformance MonitorA
Read-onlyIdempotent

Performance monitor configuration and counters for the RAS farm — resource utilisation thresholds and monitoring settings. Use this to review performance baselines or check monitoring configuration.

Inputs: no named parameters.

ras_farm_get_reportingReportingA
Read-onlyIdempotent

Reporting configuration for the RAS farm — report scheduling, data retention, database connection. Use this to verify reporting is enabled and properly configured.

Inputs: no named parameters.

ras_farm_get_versionWeb Service VersionA
Read-onlyIdempotent

RAS web service (REST API) version information. Returns the current API version and build number. Use this to verify the API version is compatible or check which features are available.

Inputs: no named parameters.

ras_infra_get_agentsRAS AgentsA
Read-onlyIdempotent

List all Parallels RAS agents deployed across the farm — hostname, IP, OS, agent version, and current status. Use this to verify agent deployment, diagnose connectivity, or check agent versions. Supports fields, filter, and limit to narrow large result sets.

Inputs: limit, fields, filter.

ras_infra_get_certificatesCertificatesA
Read-onlyIdempotent

Certificate inventory for the RAS farm — names, expiration dates, issuers, and usage. Use this to audit SSL/TLS certificates, check for upcoming expirations, or verify assignments.

Inputs: limit, fields, filter.

ras_infra_get_connection_brokersConnection BrokersA
Read-onlyIdempotent

Connection broker status, priority, and configuration. Brokers handle user session brokering and load distribution. Use this to check broker health, verify primary/secondary priority, or diagnose session routing.

Inputs: limit, fields, filter.

ras_infra_get_enrollment_statusEnrollment ServersA
Read-onlyIdempotent

Enrollment server status. Enrollment servers handle SCEP certificate enrollment for device management. Use this to check enrollment server health or troubleshoot certificate enrollment failures.

Inputs: limit, fields, filter.

ras_infra_get_gateway_statusGateway StatusA
Read-onlyIdempotent

Status of RAS Secure Client Gateways — connection state, IP addresses, tunnel mode. Gateways provide external user access to published resources. Use this to monitor gateway health or troubleshoot external connectivity.

Inputs: limit, fields, filter.

ras_infra_get_halb_statusHALB StatusA
Read-onlyIdempotent

Status of HALB (High Availability Load Balancer) devices in the farm — device health, IP addresses, operational state. Use this to monitor load balancer availability or diagnose gateway connectivity.

Inputs: limit, fields, filter.

ras_infra_get_providersProvidersA
Read-onlyIdempotent

List all cloud and hypervisor providers configured in the RAS farm — AVD, AWS EC2, Azure, Hyper-V, Nutanix, vCenter, VMware ESXi. Use this to verify provider connectivity, check provider types, or audit multi-cloud config.

Inputs: limit, fields, filter.

ras_infra_get_rds_hostpoolsRDS Host PoolsB
Read-onlyIdempotent

List RDS host pool membership and configuration. Host pools group RDS servers for load balancing and resource allocation. Use this to review pool composition, check host assignments, or verify pool settings.

Inputs: limit, fields, filter.

ras_infra_get_rds_hostsRDS HostsA
Read-onlyIdempotent

List RDS session hosts — hostname, IP, agent status, active sessions, CPU/RAM usage, OS version. Use this to monitor host health, check capacity, or troubleshoot RDS issues. On large farms, narrow with filter (e.g. {status: 'online'}) or fields to keep responses small.

Inputs: limit, fields, filter.

ras_infra_get_saml_idpsSAML Identity ProvidersA
Read-onlyIdempotent

List SAML identity providers configured for SSO — provider names, metadata URLs, configuration details. Use this to audit SSO configuration or troubleshoot SAML authentication.

Inputs: limit, fields, filter.

ras_infra_get_sitesSitesA
Read-onlyIdempotent

List all sites configured in the RAS farm and their status. Multi-site deployments distribute infrastructure across locations. Use this to check site connectivity, verify configuration, or audit farm topology.

Inputs: limit, fields, filter.

ras_infra_get_themesThemesA
Read-onlyIdempotent

List user portal themes configured in the RAS farm — branding, logos, customisation settings. Use this to review portal appearance configuration or verify theme assignments.

Inputs: limit, fields, filter.

ras_infra_get_vdi_hostpoolsVDI Host PoolsA
Read-onlyIdempotent

List VDI host pool configuration — pool members, provisioning settings, capacity. Use this to review VDI pool composition, check desktop provisioning status, or verify pool sizing.

Inputs: limit, fields, filter.

ras_infra_get_vdi_templatesVDI TemplatesA
Read-onlyIdempotent

List VDI templates, their status, and configuration. Templates define the base image and settings for provisioned VDI desktops. Use this to check template versions, maintenance mode, or provisioning settings.

Inputs: limit, fields, filter.

ras_policies_listClient PoliciesA
Read-onlyIdempotent

List all Parallels RAS client policies — policy names, settings, and assignment status. Client policies control user experience settings (display, audio, printing, device redirection). Use this to audit policy configuration or troubleshoot client behaviour. Policies can be deeply nested — use fields to project only top-level metadata when you don't need every rule.

Inputs: limit, fields, filter.

ras_pub_get_all_itemsAll Published ItemsA
Read-onlyIdempotent

List all published items across all resource types (RDS, VDI, AVD apps and desktops) in a single view. Use this for a complete overview of everything published in the farm. Large farms can return thousands of items — narrow with filter (e.g. {type: 'App'}) or project with fields to keep responses small.

Inputs: limit, fields, filter.

ras_pub_get_avd_appsPublished AVD AppsA
Read-onlyIdempotent

List published Azure Virtual Desktop applications. AVD apps are delivered from Azure-hosted session hosts. Use this to review AVD app assignments or verify Azure-based application publishing.

Inputs: limit, fields, filter.

ras_pub_get_avd_desktopsPublished AVD DesktopsB
Read-onlyIdempotent

List published Azure Virtual Desktop resources. AVD desktops are delivered from Azure-hosted session hosts. Use this to review AVD desktop assignments or verify Azure-based desktop publishing.

Inputs: limit, fields, filter.

ras_pub_get_foldersPublishing FoldersA
Read-onlyIdempotent

List published resource folders that organise applications and desktops into logical groups for end users. Use this to review folder hierarchy, check resource organisation, or verify folder-level access.

Inputs: limit, fields, filter.

ras_pub_get_rds_appsPublished RDS AppsA
Read-onlyIdempotent

List published RDS applications — app names, executable paths, server associations, user filter assignments. Use this to review which apps are published via RDS, check app configurations, or troubleshoot launch issues.

Inputs: limit, fields, filter.

ras_pub_get_rds_desktopsPublished RDS DesktopsA
Read-onlyIdempotent

List published RDS desktop resources. RDS desktops deliver full Windows desktops from shared session hosts. Use this to review RDS desktop assignments or troubleshoot launch issues.

Inputs: limit, fields, filter.

ras_pub_get_statusPublishing StatusA
Read-onlyIdempotent

Overall publishing service status and health. Returns whether the publishing agent is operational and any pending changes. Use this to verify publishing is functioning or diagnose why resources are unavailable.

Inputs: no named parameters.

ras_pub_get_vdi_appsPublished VDI AppsA
Read-onlyIdempotent

List published VDI applications. VDI apps run on dedicated virtual machines rather than shared RDS hosts. Use this to review VDI-published applications or compare with RDS app assignments.

Inputs: limit, fields, filter.

ras_pub_get_vdi_desktopsPublished VDI DesktopsA
Read-onlyIdempotent

List published VDI desktop resources. VDI desktops deliver dedicated virtual machines per user. Use this to review assignments or verify per-user desktop allocation.

Inputs: limit, fields, filter.

ras_sessions_listActive RD SessionsA
Read-onlyIdempotent

List active remote desktop sessions across the RAS farm — username, client IP, device name, state, screen resolution, and connected server. Use this to monitor active users, check session counts, troubleshoot connectivity, or identify idle/disconnected sessions. Supports fields, filter, and limit — prefer narrowing over fetching everything on large farms.

Inputs: limit, fields, filter.

ras_site_get_ad_integrationAD IntegrationA
Read-onlyIdempotent

Active Directory integration configuration — domain settings, forest trust relationships, OU mappings. Use this to verify AD connectivity, check domain join status, or troubleshoot authentication issues.

Inputs: no named parameters.

ras_site_get_connection_settingsConnection SettingsA
Read-onlyIdempotent

Connection and authentication settings — session timeouts, client connection policies, authentication methods. Use this to review security posture or troubleshoot client connection issues.

Inputs: no named parameters.

ras_site_get_cpu_optimizationCPU OptimizationA
Read-onlyIdempotent

CPU optimization settings for the site. Controls how CPU resources are allocated across user sessions. Use this to review resource management policies or troubleshoot performance issues.

Inputs: no named parameters.

ras_site_get_load_balancingLoad BalancingA
Read-onlyIdempotent

Load balancing settings — balancing method, resource weights, session limits. Use this to review how sessions are distributed across RDS hosts or diagnose uneven load distribution.

Inputs: no named parameters.

ras_site_get_mfaMFA ConfigurationA
Read-onlyIdempotent

Multi-factor authentication provider configuration — enabled MFA providers (TOTP, RADIUS, Deepnet, SafeNet, Email OTP), criteria rules, bypass conditions. Use this to audit MFA security posture or troubleshoot MFA login failures.

Inputs: no named parameters.

ras_site_get_notificationsNotification EventsA
Read-onlyIdempotent

Notification event configuration — alert triggers, email notifications, event thresholds. Use this to review which events trigger admin notifications or verify alerting is configured.

Inputs: limit, fields, filter.

ras_site_get_printingPrinting SettingsA
Read-onlyIdempotent

Printing configuration — printer redirection, universal printing options, driver policies. Use this to troubleshoot print redirection issues or review printing policy configuration.

Inputs: no named parameters.

ras_site_get_tenant_brokerTenant Broker StatusA
Read-onlyIdempotent

Tenant broker status and join information. The tenant broker enables multi-tenant RAS deployments. Use this to verify tenant broker connectivity or check join status for managed sites.

Inputs: no named parameters.

ras_site_get_url_redirectionURL RedirectionA
Read-onlyIdempotent

URL redirection rules configured for the site. URL redirection allows specific URLs opened on RDS hosts to be redirected to the client device browser. Use this to review redirection rules or troubleshoot URL handling.

Inputs: limit, fields, filter.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 43 tools

    Disambiguation4/5

    Tools are mostly organized by distinct RAS domains (farm, site, infra, pub) and resource types, making purposes clear. However, ras_pub_get_all_items overlaps with the specialized app, desktop, and folder listing tools, creating some ambiguity about when to use the aggregate versus targeted getters.

    Naming Consistency4/5

    All tools use a consistent ras_<domain>_<verb>_<resource> pattern with snake_case, which is highly predictable. The minor inconsistency is that listing operations sometimes use get (e.g., ras_infra_get_agents) and sometimes list (e.g., ras_sessions_list, ras_policies_list).

    Tool Count2/5

    43 tools is well above the typical 3-15 range and exceeds the 25+ threshold where count becomes a usability concern. Many granular getters for individual settings could be consolidated or parameterized without losing functionality.

    Completeness2/5

    The tool surface is entirely read-only: every tool is a get, list, or search operation. There are no create, update, delete, or action tools for any RAS resource, so agents cannot perform lifecycle management or remediation tasks, leaving significant gaps for an administration-focused server.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server that allows AI assistants to query and monitor KVM Fleet devices, audit logs, and console sessions through the official REST API.
      5
      8 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server that provides tools to list and read devices, MDM servers, blueprints, configurations, apps, packages, users, and other resources from Apple Business Manager and Apple School Manager.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server for Proxmox VE that provides AI assistants with structured visibility into cluster nodes, guests, storage, and Docker workloads. It is designed to prevent any mutating operations by construction.
      12
      MIT