À propos du projet

Windows-MCP est un serveur MCP (Model Context Protocol) léger et open source qui fait le pont entre les agents IA et le système d'exploitation Windows. Il permet aux agents d'effectuer la navigation dans les fichiers, le contrôle des applications, l'interaction avec l'interface utilisateur et les tests QA en exposant l'automatisation de l'interface utilisateur Windows sous forme d'outils MCP. Capacités clés : - Intégration Windows native : ouvre des applications, contrôle les fenêtres, simule les entrées clavier et souris, et capture l'état des fenêtres/de l'interface utilisateur. - Fonctionne avec n'importe quel LLM ; aucun pipeline de vision par ordinateur traditionnel ni modèle affiné n'est requis, et la vision est facultative. - Ensemble d'outils pour l'automatisation de l'interface utilisateur couvrant les opérations clavier/souris de base et les captures d'écran ou d'état de l'interface utilisateur. - Mode DOM pour l'automatisation du navigateur : une option `use_dom=True` sur l'outil State se concentre sur le contenu de la page web et filtre le chrome du navigateur. Il prend en charge Chrome, Edge et Firefox (Firefox utilise une solution de repli IAccessible2). - La latence typique signalée entre les actions est d'environ 0,2 à 0,5 seconde, variant selon la charge du système et la vitesse d'inférence du LLM. Installation et exécution : - Nécessite Python 3.13+ et le gestionnaire de paquets uv. L'anglais est recommandé comme langue d'affichage de Windows ; sinon, l'outil App doit être désactivé. - Peut être exécuté directement avec `uvx windows-mcp serve`, ou installé en tant que tâche planifiée par utilisateur via `windows-mcp install` (avec `uninstall` pour le supprimer). Les journaux vont dans `~/.windows-mcp/`. - Prend en charge les transports stdio (par défaut), SSE et streamable-http. Des instructions de configuration sont fournies pour Claude Desktop, Perplexity Desktop, Gemini CLI, Qwen Code, Codex CLI, Autohand Code et Claude Code, y compris le pontage WSL via powershell.exe. Sécurité et contrôle d'accès : - Authentification par jeton Bearer, listes d'autorisation IP avec plages CIDR, listes d'autorisation d'origine CORS facultatives, TLS/HTTPS via des fichiers de certificat et de clé, et OAuth 2.0 avec PKCE pour les clients compatibles. - Sélection des outils via la liste blanche `--tools` ou la liste noire `--exclude-tools`. - La configuration peut être stockée dans `~/.windows-mcp/config.toml`, les indicateurs CLI remplaçant les valeurs du fichier. Un assistant `auth` peut générer des clés et des certificats auto-signés. - L'outil Scrape bloque les adresses IP privées, les adresses de bouclage, les adresses lien-local, les identifiants dans les URL et les schémas non HTTP. Les variables d'environnement couvrent la mise à l'échelle des captures d'écran et le backend de capture (dxcam/mss/pillow), le profilage des instantanés, la désactivation du flash de capture, les paramètres de sécurité, le mode HTTP sans état, la télémétrie anonyme (activée par défaut, peut être désactivée) et la journalisation de débogage. Un chien de garde de focus UIA est disponible mais désactivé par défaut. Le projet est sous licence MIT et publié sur PyPI et le registre MCP.