💻 mcp-vnc

AIエージェントがWindows、Linux、macOS、またはVNCサーバーを実行できるその他のあらゆる環境（心配しないでください、おそらく問題ありません）をリモート制御できるようにするModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

NPMからインストール

npm install -g @hrrrsn/mcp-vnc

ソースからインストール

git clone https://github.com/hrrrsn/mcp-vnc
cd mcp-vnc
npm install
npm run build

Related MCP server: mcp-vnc

⚙️ 設定

Claude Desktop

1. Claude Desktopの設定ファイルを探して開いてください:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 次の設定を追加してください:

NPMインストールの場合:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

ソースからビルドした場合:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

VNC_TIMEOUT（オプション）は、各ツール呼び出しがVNCサーバーへの接続と初期フレームの配信を待機する時間をミリ秒単位で設定します。デフォルトは 30000 です。

VS Code

VS Codeのドキュメントを参照してください。

HTTPトランスポート（Streamable HTTP）

デフォルトでは、サーバーはstdioを使用します。代わりにHTTPで公開するには:

# Via environment variables
VNC_HOST=192.168.1.100 VNC_PORT=5900 VNC_PASSWORD=secret \
MCP_TRANSPORT=http MCP_PORT=3000 mcp-vnc

# Or via CLI arguments
mcp-vnc --http --port 3000

MCPエンドポイントは http://localhost:3000/mcp で利用可能になります。クライアント設定の例:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

🛠️ 利用可能なツール

MCPサーバーは、リモートデスクトップを制御するための以下のツールを提供します:

🖱️ マウス操作

例: vnc_click(x=100, y=200, button="right", double=true)

例: vnc_move_mouse(x=500, y=300)

⌨️ キーボード操作

対応キー:

• 単一キー: a, Enter, F1, Escape, Up, Down, Tab, Space

• キーの組み合わせ: Ctrl+c, Alt+F4, Ctrl+Alt+Delete, Shift+Tab

• 修飾キー: Ctrl, Alt, Shift, Super/Win, Meta/Cmd

例:

• vnc_key_press(key="Enter")

• vnc_key_press(key="Ctrl+Alt+Delete")

📝 テキスト入力

例: vnc_type_text(text="Hello World!", enter=true)

例: vnc_type_multiline(lines=["Line 1", "Line 2", "Line 3"])

📸 スクリーンキャプチャ

例: vnc_screenshot(delay=1000) - キャプチャ前に1秒待機します

🤝 コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送ってください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルを参照してください。