# WinShun [Health: Active]

**Category:** 🖥️ OS Automation  
**Repository:** https://github.com/LingCore/WinShun  
**GitHub Stars:** 1001  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/winshun

## Description
Win顺：免费开源的 Windows 快速搜索启动器。双击 Ctrl，拼音秒搜文件、全文搜索 Word/Excel/PDF、剪贴板历史（代替 Win+V）、对话框搜索、任务栏搜索、插件、AI 助手 MCP。Free Windows search launcher: pinyin file search, full-text search, clipboard history, MCP server. Everything/Listary alternative.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What WinShun does

WinShun is a Windows search launcher with an MCP interface for AI assistants. Its core search functions cover file names and file contents, allowing users to find documents by filename, pinyin input, or text contained in supported files. Content search includes Word, Excel, PowerPoint, PDF, and code files. Searches can also be narrowed to a particular folder, and a semantic search mode can locate documents by meaning rather than an exact phrase.

The launcher is designed for Windows 10 and Windows 11 on 64-bit systems. Outside its MCP use, WinShun provides a keyboard-driven way to open applications, Windows settings, Control Panel items, folders, and web searches. It also includes favorites, plugins, file-dialog search, clipboard history, screenshots, screen recording, scrolling screenshots, and pinned images.

## How it works

The desktop launcher opens when the user presses Ctrl twice. Queries can use pinyin for file and application lookup, type prefixes for file categories, or content terms for document searches. Results can show details such as dates and file sizes, and the interface supports direct keyboard selection. Searching from an Explorer folder can limit results to that folder.

For document-content searches, WinShun can show matching text and file details, with views for text, previews, summaries, and reports. Clipboard history can index text and perform OCR on copied images, making text inside screenshots searchable. These desktop capabilities provide the Windows search context used by the MCP feature for AI-assisted workflows.

## Tools and capabilities

- Search files across the PC using names, pinyin, file-type prefixes, or modification dates.
- Search inside Word, Excel, PowerPoint, PDF, and code files.
- Search document content within a selected folder.
- Find applications, Windows settings, Control Panel items, folders, favorites, and web results.
- Search clipboard history, including text recognized from copied images through OCR.
- Use plugins such as calculator, unit conversion, and color utilities.
- Access screenshot, region-recording, scrolling-capture, and pinning features from the launcher.

## Limitations and notes

WinShun is a Windows-only application targeting Windows 10 and Windows 11 on x64 hardware. Its search coverage depends on the file types and content that WinShun supports; the documented formats include Word, Excel, PowerPoint, PDF, and code files. The MCP capability is presented as part of the WinShun application rather than as a standalone cross-platform search service.

The project is open source under the MIT license. A separate WinShun plugin library is available for installing, updating, and developing community plugins. Keyboard behavior, search scope, and launcher features are centered on the Windows desktop environment, so this server is best suited to assistants operating alongside a WinShun installation.

_Full upstream README: https://allmcps.com/mcp/winshun/readme_