solisk-pc-mcp について
solisk-pc-mcpは、AIクライアント向けのPC制御MCPサーバーで、ファイル、シェル、GUI入力、クリップボード、音声の承認制ツールを提供します。CLI、Windowsデスクトップの操作画面、Webダッシュボードを備え、アクセスとセッションも管理できます。
主な機能
- 01Windowsネイティブツール97種
- 02ポータブルツールとシェル実行
- 03承認制のPCアクセス
- 04CLIとWebダッシュボード
- 05キー、セッション、経路の管理
活用シーン
- 01AIクライアントからのPC操作
- 02ツールセッションの承認と監視
- 03アクセスキーと公開経路の管理
- 04LinuxやmacOSでのダッシュボード利用
MCP 対応
URL経由でMCPクライアントにPC制御ツールを提供します。クライアントは同意とルームキーで認証し、READMEにはOAuth 2.1とリレーの選択肢も記載されています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ヒント
1 つの製品、3 つの顔、マシンごとに 1 つのランタイム。 URL で任意の MCP クライアントを接続し、一度承認すれば、97 個のツールを呼び出せます。すべてのセッションを確認し、あらゆる経路を切り替え、必要なものをいつでも取り消せます。すべての OS で CLI、Windows ではデスクトップのコントロールルーム、どこからでも Web ダッシュボード(
/app)を利用できます。
インストール
npm install -g solisk # Node 22.5+ · or run without installing: npx solisk
solisk setup # room name, owner key, approval mode — step by step
solisk --mode=http # MCP server on 127.0.0.1:3000 (default)
solisk dashboard # web control room at /app
Windows、Linux、macOS のサーバーで同じコマンドを実行できます。Windows 以外では、移植可能な 45 個のツールと shell_exec を提供します。Windows 専用の自動化機能は提供されません。/app ダッシュボードは、すべての OS でコントロールルームとして利用できます。
Windows GUI
- Releases から
PC Control MCP 1.0.0.msiをダウンロードします。従来のSetup .exeも付属しています。 - 実行すると、CLI と同じエンジンを使った、クリック操作ができるコントロールルームが起動します。
- すでに CLI をお持ちの場合は、
solisk gui setup --installer <path-to-.msi>を実行すると、サイレントインストールできます。 - Linux/macOS では、仕様により
solisk guiは実行を拒否し、Web ダッシュボードを案内します。
警告
ビルドは署名されていないため、SmartScreen による確認が一度表示されます。詳細情報 → 実行を選択してください。EV 証明書でこの警告は解消されます。予算は確保済みですが、まだ対応していません。
60 秒で AI に接続
flowchart LR
A[Copy MCP URL<br/>from Setup] --> B[Paste as connector<br/>in Claude / ChatGPT]
B --> C[Approve once<br/>consent + room key]
C --> D[Calling tools.<br/>Reconnects need no re-auth.]
style D fill:#4fd1b5,color:#03211b
| 接続 | 認証 | 制御 |
|---|---|---|
![]() | ![]() | ![]() |
メモ
初回の接続は失敗するものの、再試行すると成功する場合がありますか? Claude が失敗した検出結果をキャッシュしています。コネクターを一度削除して追加し直すと、同意画面が直接表示されます。
セキュリティモデル
| # | 保証 | 方法 |
|---|---|---|
| 1 | Bearer のみ | すべてのデータルートで、オーナーキー、スコープ付きキー、OAuth トークン、またはデバイス Cookie を使用します。シェルは公開されますが、データは公開されません。 |
| 2 | ゼロトラストリレー | 1 バイトでも転送する前に認証します。乗っ取りは記録され、ブロックされます。 |
| 3 | PKCE +厳密なリダイレクト+バインドされたトークン | ルームをまたいだトークンの再利用は一切できません。 |
| 4 | 保存時にハッシュ化 | 一意のソルトを使用する scrypt。シークレットがログやディスクに平文で書き込まれることはありません。 |
| 5 | フェイルクローズ | セッションが不明な場合 → 再初期化します。オフラインの場合 → ローカルは動作を継続し、リモートは再接続します。リレーは 300 回/分、ローカルは 400 回/分、セッションは 5 件、アイドル時に期限切れになります。 |
| 6 | 意図的な破棄 | ファネル、ターボ、URL の再生成では、すべて事前に確認し、何が起きるかを明示します。 |
ポリシーの全文:SECURITY.md · 問題を見つけましたか? セキュリティアドバイザリ — 公開 Issue ではありません。
すべてをリアルタイムで
| 4 つの接続方法 | ホスト型リレー · Cloudflare トンネル(クイックまたは独自ドメイン)· テイルネット · ウェブダッシュボード。どれもリアルタイムで切り替えられます。ダッシュボードを終了すると、テイルネットだけでなく /app も 404 を返します。 |
| 正確なセッション数 | ライブ AI が 1 つなら 1 と表示されます。ゴーストセッションは 10 分間操作がないと期限切れになり、GUI、CLI、API のすべてで実際のセッション数が表示されます。 |
| 用途に合ったキー | スコープ付きクライアントキー、フェイルクローズのデフォルト、ダウンタイムなしのローテーション、30 日間記憶されるデバイス。 |
| 競合しないランタイム | CLI は実行中の GUI に接続して、そのキーを透過的に借用し、2 つ目のサーバーを起動して GUI に重ねることを拒否します。 |
| アップデート | アプリ内のリリースノート、バージョンを飛ばしたアップデートに対応し、必須アップデートはスキップできません。 |
アーキテクチャ
flowchart TB
AI["AI client<br/>Claude.ai / ChatGPT / Cursor"]
AI -->|MCP URL + OAuth 2.1<br/>PKCE S256, resource-bound tokens| RELAY
subgraph RELAY["Cloud relay"]
R1[rooms · tokens · rate limits<br/>scrypt-hashed keys]
end
RELAY -->|one outbound WebSocket per PC<br/>takeover-protected| PC
subgraph PC["Your machine :3000"]
P1[StreamableHTTP · 97 tools · 5 sessions max]
P2[Cloudflare tunnel<br/>quick or your domain]
P3[tailnet serve · web dashboard /app]
end
設定ファイルは 1 つ、イベントバスは 1 つ、セッションストアは 1 つです。薄いフロントエンド(Electron、CLI、ウェブシム)は状態を保持しません。
OS サポート
| OS | CLI(solisk) | ウェブダッシュボード(/app) | GUI | ツール |
|---|---|---|---|---|
| Windows 10/11 x64 | ✅ ローカル + リレー + トンネル | ✅ | ✅ フルコントロールルーム | 97 ネイティブ |
| Linux | ✅ サーバー · stdio · トンネル · Tailscale | ✅ | ❌ — solisk gui は起動を拒否し、/app を案内します | 45 ポータブル + shell_exec |
| macOS | ✅ サーバー · stdio | ✅ | ❌ — 同様です | 45 ポータブル + shell_exec |
Windows 専用の自動化(マウス/キーボードのフック、スクリーンショット、ネイティブダイアログ)は他の環境では無効になり、ポータブルな機能はすべて引き続き利用できます。リレー、トンネル、OAuth、キー、記憶されたデバイス、セッション、アップデートの確認は、3 つの OS すべてで同じです。
要件
- CLI には Node ≥ 22.5 が必要です。
- GUI には Windows 10/11 x64 が必要です。
- それ以外は不要です — localhost での使用に Docker やリバースプロキシは必要ありません。
リレーをセルフホストする
ssh root@YOUR_VPS
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Kyzenkms/solisk-pc-mcp/main/self-hosted-setup/vps/install.sh)"
スクリプトの動作
ドメインの種類(独自ドメイン、またはテスト用の sslip.io)、続いてランタイム(Docker または PM2)を選択し、アプリに貼り付けるルームとキーを表示します。バックアップ、ファイアウォール、アップデートについては、self-hosted-setup/README.md を参照してください。
CLI リファレンス
コマンドは solisk です — pc-control は互換性エイリアスとして引き続き使用できます。
日常的な操作
solisk dashboard [--no-open] web console for the running server
solisk doctor [--fix] 11 health checks — 0 failing is the goal
solisk logs [--lines N] live server log, whichever face owns it
solisk setup step-by-step onboarding wizard
solisk backup config snapshot for restores
アクセス制御
solisk config get|set|validate ports, modes, domains (secrets refused)
solisk rotate-key new owner key, zero-downtime rotation
solisk keys list|add|revoke scoped client keys (fail-closed defaults)
solisk devices list|revoke remembered browsers
solisk relay status|retry room state, redial
公開設定
solisk tunnel off|quick|custom + login, create, route, forget, status
solisk tailscale status|serve|off funnel is deliberate and confirmed
solisk gui status|setup detect install, install from .exe or .msi
すべての接続コマンドは、実行中の GUI の隣であればフラグなしで動作します。
検証
cd relay-server && node --test test/oauth.test.js # OAuth regression suite
node test-live.js # end-to-end vs a running server
solisk doctor # this machine — 0 failing is the goal
よくある質問
1 つの AI に N 個のセッションが表示される
再接続時の古い ID です。アイドル状態が 10 分続くと期限切れになります。接続時のライブカウントは正確です。
GUI の実行中に CLI でキーが拒否される
GUI のキーが自動的に使用され、そのことが通知されます(フィンガープリントが表示されます)。
solisk gui status で両方のフィンガープリントを確認できます。
再起動後にセッション数が 0 と表示される
正常です。セッションはメモリ上に保存されます。クライアントが再初期化されると、すぐにセッション数が表示されます。許可設定とキーは保持されるため、再認証は不要です。
Linux で GUI を実行できますか?
いいえ。設計上、コントロールルームは Windows 専用です。Linux と macOS では CLI と、ブラウザー上で同じコントロールルームを利用できるウェブダッシュボード
/app をお使いください。
MIT · Solisk PC Control MCP · v1.0.0 · solisk.org
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。


