Parallels RAS MCP Server
Parallels RAS MCP Server
RAS REST API を介して Parallels Remote Application Server (RAS) インフラストラクチャを照会するための、コミュニティ管理による読み取り専用の Model Context Protocol (MCP) サーバーです。
AI アシスタントに、RAS 環境(インフラストラクチャ、サイト設定、ポリシー、公開設定、セッション)の可視性を提供します。設定の変更は一切行いません。
Parallels International GmbH とは提携していません。「Parallels」は各所有者の商標です。
スコープと使用目的
MCP_TRANSPORT 環境変数で選択可能な 2 つのトランスポートをサポートしています。
stdio(デフォルト) — MCP クライアント(Claude Desktop、Claude Code、Cursor など)によってローカルのサブプロセスとして起動されます。個々の管理者が自分のワークステーションで使用する場合や、開発・テスト環境を想定しています。認証情報は起動プロセスの環境から取得され、ネットワークリスナーは存在しません。http— ベアラートークンを必須とするストリーミング可能な HTTP リスナーです。1 つのサーバーを複数のクライアントで共有する信頼されたネットワーク環境(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 サーバーのホスト名または IP アドレス |
| はい | — | 管理者のユーザー名 |
| はい | — | 管理者のパスワード |
| いいえ |
| REST API ポート |
| いいえ |
| TLS 証明書の検証をスキップ(自己署名証明書用) |
トランスポート
変数 | 必須 | デフォルト | 説明 |
| いいえ |
|
|
| HTTP のみ | — | クライアントが |
| いいえ |
| バインド先アドレス。すべてのインターフェースで公開するには |
| いいえ |
| リッスンポート。 |
設定
以下の例は、デフォルトであり、ほとんどのユーザーが使用する stdio トランスポートを対象としています。HTTP トランスポートについては、後述の Running over 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シェルまたは Claude Code MCP 設定で環境変数を設定します。
Cursor
Cursor の設定で Features → MCP Servers に移動し、以下を追加します。
Name:
parallels-rasCommand:
node /path/to/ParallelsRAS_MCP/build/index.jsEnvironment:
RAS_HOST,RAS_USERNAME,RAS_PASSWORD
その他の MCP 対応クライアント
MCP over stdio をサポートするクライアントの場合は、以下を指定します。
node /path/to/ParallelsRAS_MCP/build/index.jsクライアントの MCP サーバー設定で必要な環境変数を設定してください。
HTTP での実行
HTTP トランスポートは MCP Streamable HTTP を実装しており、常駐プロセスとして実行されます。信頼されたネットワーク上で複数のクライアントが 1 つのサーバーを共有する場合(通常は 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> を含める必要があります。トークンが欠落しているか間違っている場合は 401 が返されます。
クライアントの接続
ストリーミング可能な HTTP MCP サーバーをサポートするクライアントの場合は、Authorization ヘッダーにベアラートークンを含めて http://<host>:<port>/mcp を指定します。例:Claude Code CLI:
claude mcp add parallels-ras --transport http \
--header "Authorization: Bearer $MCP_HTTP_BEARER_TOKEN" \
http://your-server:3000/mcp本番環境チェックリスト
常に TLS をフロントに配置してください。MCP サーバーを
127.0.0.1にバインドし、プロキシ経由でのみアクセスできるようにした上で、リバースプロキシ(nginx、Caddy、Traefik)で HTTPS を終端します。MCP_HTTP_BEARER_TOKENは認証情報として扱ってください。少なくとも 32 バイトのエントロピーを確保し、シークレットマネージャーに保存し、スタッフが退職した際にはローテーションしてください。ネットワークの到達範囲を制限してください(ファイアウォール、VPN、プライベートサブネット)。ベアラーチェックはサーバー自体における唯一の認証レイヤーです。
RAS 管理者の認証情報はリスナーと同じホスト上に存在します。そのホストへのシェルアクセス権を持つ者は誰でも認証情報を読み取ることができます。マルチテナント環境のボックスでこれを実行しないでください。
利用可能なツール(合計 41 個)
すべてのツールは読み取り専用であり、互換性のあるクライアントで自動承認されるよう readOnlyHint: true が注釈されています。
インフラストラクチャ (14)
ツール | 説明 |
| すべての RAS エージェントとそのステータスを一覧表示 |
| 接続ブローカーのステータスと優先度 |
| クラウド/ハイパーバイザープロバイダー (AVD, AWS, Azure, Hyper-V など) |
| RDS セッションホスト |
| RDS ホストプール |
| 証明書インベントリ |
| HALB デバイスのステータス |
| エンロールメントサーバーのステータス |
| VDI ホストプール |
| VDI テンプレート |
| Secure Client Gateway のステータス |
| ファームサイトとそのステータス |
| SSO 用の SAML ID プロバイダー |
| ユーザーポータルのテーマとブランディング |
サイト設定 (9)
ツール | 説明 |
| Active Directory 統合設定 |
| 接続および認証設定 |
| ロードバランシング設定 |
| MFA プロバイダー設定 |
| 印刷設定 |
| テナントブローカーのステータス |
| 通知イベント設定 |
| URL リダイレクトルール |
| CPU 最適化設定 |
FSLogix は REST API ではサイトスコープで公開されていません。ホストプールごと、AVD テンプレートごと、または PowerShell を介して設定されます。
ポリシー (1)
ツール | 説明 |
| すべてのクライアントポリシーを一覧表示 |
ファーム設定 (7)
ツール | 説明 |
| 管理者アカウントとロール |
| ファーム設定 |
| ライセンス状況とシート使用状況 |
| Web サービスバージョン |
| パフォーマンスモニター設定 |
| SMTP メールボックス設定 |
| レポート設定 |
公開設定 (9)
ツール | 説明 |
| 公開された RDS アプリケーション |
| 公開された VDI アプリケーション |
| 公開された AVD アプリケーション |
| 公開された RDS デスクトップ |
| 公開された VDI デスクトップ |
| 公開された AVD デスクトップ |
| リソースフォルダー |
| 公開サービスのステータス |
| すべての公開アイテム(統合ビュー) |
RD セッション (1)
ツール | 説明 |
| アクティブなリモートデスクトップセッション |
拡張
新しいツールを追加するには:
src/tools/内にファイルを作成または開きます(例:notifications.ts)。register(server: McpServer): void関数をエクスポートします。公式 RAS REST API に存在するパスを指定して
rasClient.get("/api/<Resource>")を呼び出します。src/index.tsでregister関数をインポートして呼び出します。npm run buildを実行します。
モジュールファイル名(infrastructure.ts, site-settings.ts など)は、関連するツールの内部的なグループ化のためのものです。これらは URL セグメントとは一致しません。実際の RAS API は /api/<PascalCaseResource>(例: /api/Agent, /api/License, /api/MFA)の下でフラットに構成されています。
API リファレンス
ブラウザリファレンス: https://docs.parallels.com/landing/ras-rest-api-guide
API ベース URL:
https://<ras-host>:20443/api/
ロードマップ
書き込み操作 — このリポジトリのスコープ外です。RAS の状態を変更するツールは別のサーバーでホストすべきであり、それにより、ここにある読み取り専用ツールは自動承認しても安全な状態を維持できます。
HTTP トランスポート用の OAuth / OIDC — 現在は単一の共有ベアラートークンです。ユーザーごとの ID を導入することで、認証情報を共有せずに複数のクライアントがデプロイメントを共有できるようになります。
コントリビューション
Issue やプルリクエストを歓迎します。小さな修正を超える変更については、アプローチについて合意できるよう、まず Issue を作成してください。
履歴
v1.1.0 — 既存の stdio トランスポートに加え、ベアラートークン認証を備えたオプトインのストリーミング可能な HTTP トランスポートを追加。
v1.0.1 — Parallels RAS v21 REST API に対して 41 個すべてのツールパスを修正し、バンドルされた OpenAPI 仕様に対するビルド時のパス検証機能 (
scripts/verify-tool-paths.mjs) を追加。v1.0.0 — ドラフト版。REST API パスは実際のエンドポイントではなく、ドキュメントの目次見出しからモデル化されていました。v1.0.1 により置き換えられました。
ライセンス
Available Tools
43 toolsras_docs_get_pageGet Parallels Documentation PageARead-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_docs_searchSearch Parallels DocumentationARead-onlyIdempotent
Search the official Parallels documentation for relevant pages, code examples, API references, and feature guides. Use this to validate configuration found via the RAS API tools, look up the documented behaviour of a feature, or find the right page before fetching it in full with ras_docs_get_page. Returns one or more excerpts with titles and direct links.
Inputs: query (required).
ras_farm_get_administratorsFarm AdministratorsARead-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 ConfigurationARead-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_licensingLicensingARead-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 SettingsARead-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 MonitorARead-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_reportingReportingARead-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 VersionARead-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 AgentsARead-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_certificatesCertificatesARead-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 BrokersARead-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 ServersARead-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 StatusARead-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 StatusARead-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_providersProvidersARead-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 PoolsBRead-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 HostsARead-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 ProvidersARead-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_sitesSitesARead-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_themesThemesARead-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 PoolsARead-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 TemplatesARead-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 PoliciesARead-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 ItemsARead-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 AppsARead-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 DesktopsBRead-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 FoldersARead-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 AppsARead-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 DesktopsARead-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 StatusARead-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 AppsARead-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 DesktopsARead-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 SessionsARead-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 IntegrationARead-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 SettingsARead-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 OptimizationARead-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 BalancingARead-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 ConfigurationARead-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 EventsARead-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 SettingsARead-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 StatusARead-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 RedirectionARead-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
Scored across 43 tools
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.
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).
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.
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
Related MCP Connectors
Read-only MCP for AI usage profiles, leaderboards, stats, and docs; no writes or private data.
Read-only MCP server for RZ AI Labs — query its services, workshops, and contact info.
Read-only Google Analytics 4 MCP server for AI assistants.
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Related MCP Servers
AlicenseAqualityDmaintenanceRead-only MCP server that allows AI assistants to query and monitor KVM Fleet devices, audit logs, and console sessions through the official REST API.58 npm1MIT- AlicenseNot gradedqualityCmaintenanceA read-only MCP server that lets AI assistants diagnose Dell SC Series storage arrays through the array's own REST API.MIT
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseAqualityDmaintenanceA 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.12MIT