mcpField
S
solisk-pc-mcp

solisk-pc-mcp

ローカル
github.com/Kyzenkms開発ツール01 週間前に更新

solisk-pc-mcp について

solisk-pc-mcpは、AIクライアント向けのPC制御MCPサーバーで、ファイル、シェル、GUI入力、クリップボード、音声の承認制ツールを提供します。CLI、Windowsデスクトップの操作画面、Webダッシュボードを備え、アクセスとセッションも管理できます。

主な機能

  1. 01Windowsネイティブツール97種
  2. 02ポータブルツールとシェル実行
  3. 03承認制のPCアクセス
  4. 04CLIとWebダッシュボード
  5. 05キー、セッション、経路の管理

活用シーン

  1. 01AIクライアントからのPC操作
  2. 02ツールセッションの承認と監視
  3. 03アクセスキーと公開経路の管理
  4. 04LinuxやmacOSでのダッシュボード利用

MCP 対応

URL経由でMCPクライアントにPC制御ツールを提供します。クライアントは同意とルームキーで認証し、READMEにはOAuth 2.1とリレーの選択肢も記載されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"kyzenkms-solisk-pc": {
"command": "npx",
"args": [
"-y",
"solisk"
]
}
}
}
起動コマンドnpx -y solisk

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmsolisk1.0.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

ヒント

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

Solisk デスクトップのコントロールルーム
  1. Releases から PC Control MCP 1.0.0.msi をダウンロードします。従来の Setup .exe も付属しています。
  2. 実行すると、CLI と同じエンジンを使った、クリック操作ができるコントロールルームが起動します。
  3. すでに CLI をお持ちの場合は、solisk gui setup --installer <path-to-.msi> を実行すると、サイレントインストールできます。
  4. 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
接続認証制御
MCP URL をコネクターとして貼り付ける同意画面で一度承認するセッションを確認し、ツールをリアルタイムで呼び出す

メモ

初回の接続は失敗するものの、再試行すると成功する場合がありますか? Claude が失敗した検出結果をキャッシュしています。コネクターを一度削除して追加し直すと、同意画面が直接表示されます。

セキュリティモデル

#保証方法
1Bearer のみすべてのデータルートで、オーナーキー、スコープ付きキー、OAuth トークン、またはデバイス Cookie を使用します。シェルは公開されますが、データは公開されません。
2ゼロトラストリレー1 バイトでも転送する前に認証します。乗っ取りは記録され、ブロックされます。
3PKCE +厳密なリダイレクト+バインドされたトークンルームをまたいだトークンの再利用は一切できません。
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 サポート

OSCLI(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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。