Windows MCP 는 AI 에이전트와 Windows 운영 체제 간의 원활한 통합을 지원하는 가벼운 오픈 소스 프로젝트입니다. MCP 서버 역할을 통해 LLM과 Windows 운영 체제 간의 간극을 메워 에이전트가 파일 탐색, 애플리케이션 제어, UI 상호 작용, QA 테스트 등의 작업을 수행할 수 있도록 지원합니다.
https://github.com/user-attachments/assets/45976f41-7dac-47f3-93a2-2b867feb9433
✨ 주요 특징
- 원활한 Windows 통합
Windows UI 요소와 기본적으로 상호 작용하고, 앱을 열고, 창을 제어하고, 사용자 입력을 시뮬레이션하는 등의 작업을 수행합니다. - 모든 LLM 사용(Vision Optional) 많은 자동화 도구와 달리 Windows MCP는 기존의 컴퓨터 비전 기술이나 특정 미세 조정 모델에 의존하지 않습니다. 모든 LLM과 호환되므로 복잡성과 설정 시간이 줄어듭니다.
- UI 자동화를 위한 풍부한 도구 세트
기본 키보드, 마우스 조작 및 창/UI 상태 캡처를 위한 도구가 포함되어 있습니다. - 가볍고 오픈 소스
최소한의 종속성과 쉬운 설정, MIT 라이선스에 따라 제공되는 전체 소스 코드. - 사용자 정의 및 확장 가능
고유한 자동화 또는 AI 통합 요구 사항에 맞게 도구를 쉽게 조정하거나 확장할 수 있습니다. - 실시간 상호작용
동작 간(예: 마우스를 한 번 클릭하고 나서 다음 동작을 클릭할 때까지) 일반적인 대기 시간은 4~8초 이며, 활성 애플리케이션 수와 시스템 부하에 따라 약간씩 달라질 수 있습니다.
지원되는 운영 체제
- 윈도우 10
- 윈도우 11
설치
필수 조건
- 파이썬 3.12+
- Anthropic Claude 데스크톱 앱 또는 기타 MCP 클라이언트
- UV(Python 패키지 관리자),
pip install uv
로 설치
🏁 시작하기
- 저장소를 복제합니다.
지엑스피1
- 종속성 설치:
- MCP 서버에 연결
아래 JSON을 적절한 {{PATH}} 값으로 복사하세요.
Claude의 경우 Claude Desktop 구성 디렉토리에 claude_desktop_config.json이라는 이름으로 저장합니다.
- Claude Desktop을 다시 시작하세요
Claude Desktop을 열면 이제 Windows-MCP가 사용 가능한 통합으로 표시됩니다.
Claude Desktop 통합 문제 해결에 대한 추가 정보는 MCP 설명서를 참조하세요. 이 설명서에는 로그 확인 및 일반적인 문제 해결에 유용한 팁이 포함되어 있습니다.
🛠️MCP 도구
Claude는 다음 도구를 사용하여 Windows와 상호 작용할 수 있습니다.
Click-Tool
: 주어진 좌표에서 화면을 클릭합니다.Type-Tool
: 요소에 텍스트를 입력합니다(선택적으로 기존 텍스트를 지웁니다).Clipboard-Tool
: 시스템 클립보드를 사용하여 복사하거나 붙여넣습니다.Scroll-Tool
: 위/아래로 스크롤합니다.Drag-Tool
: 한 지점에서 다른 지점으로 드래그합니다.Move-Tool
: 마우스 포인터를 이동합니다.Shortcut-Tool
: 단축키(Ctrl+c
,Alt+Tab
등)를 누릅니다.Key-Tool
: 하나의 키를 누르세요.Wait-Tool
: 정의된 기간 동안 일시 중지합니다.State-Tool
: 활성 앱과 대화형 UI 요소의 결합된 스냅샷입니다.Screenshot-Tool
: 데스크탑의 스크린샷을 캡처합니다.Launch-Tool
: 시작 메뉴에서 애플리케이션을 실행합니다.Shell-Tool
: PowerShell 명령을 실행합니다.
⚠️주의
이 MCP는 Windows 운영 체제와 직접 상호 작용하여 작업을 수행합니다. 주의해서 사용하고, 이러한 위험을 용납할 수 없는 환경에는 배포하지 마십시오.
🪪라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
🤝 기여
기여를 환영합니다! 설정 지침 및 개발 가이드라인은 '기여하기'를 참조하세요.
Jeomon George 가 ❤️로 만들었습니다
This server cannot be installed
AI 에이전트가 Windows 운영 체제와 상호 작용할 수 있도록 하는 가벼운 서버로, 다양한 도구를 통해 파일 탐색, 애플리케이션 제어, UI 상호 작용, QA 테스트가 가능합니다.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI clients to interact with virtual Ubuntu desktops, allowing them to browse the web, run code, and control instances through mouse/keyboard actions and bash commands.Last updated -59JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -376MIT License
- -securityFlicense-qualityA server that enables AI systems to browse, retrieve content from, and interact with web pages through the Model Context Protocol.Last updated -
- -securityFlicense-qualityA lightweight server that enables AI assistants like Cursor & Claude to read from and write to Obsidian vaults, allowing actions like creating notes, checking existing content, and managing todos through natural language.Last updated -1928TypeScript