💻 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초 대기

🤝 기여

기여는 언제나 환영합니다! 자유롭게 Pull Request를 제출해 주세요.

📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.