Log inSubmit server
WinShun logo

WinShun

Windows MCP server for searching files and document contents through WinShun’s launcher and search features.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install WinShun

Pick your client, then add it in one click or paste the config.

No confirmed install command yet

We only publish a config when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for WinShun, and we’d rather show nothing than a guess you’d paste into your client.

Open setup steps on GitHub

Overview

WinShun MCP server connects AI assistants to WinShun, a Windows search launcher for finding files and content across a PC. WinShun supports pinyin-based file search, full-text search in Word, Excel, PowerPoint, PDF, and code files, plus application and system-setting lookup. Reach for it when an assistant needs to locate local Windows files or search inside documents through WinShun. The surrounding application also includes clipboard history, OCR, plugins, web search, and capture tools.

Use cases

  • Search local files by filename or pinyin
  • Find text inside Word, Excel, PowerPoint, and PDF files
  • Narrow document searches to a specific folder
  • Locate Windows applications and system settings
  • Search copied text and OCR content from clipboard images

Key features

  • Pinyin-based Windows file search
  • Full-text search for documents and code
  • Folder-scoped content search
  • Application and system-setting lookup
  • Clipboard history with image OCR
  • MCP access for AI assistants

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

9/9 checks healthy over the last 17d

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1kStargazers on the source repository.
Last commit1d agoMost recent push to the default branch.

How WinShun works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about WinShun

WinShun is an MCP server that connects AI assistants to the WinShun Windows search launcher. Its main tools cover local file search, pinyin-based lookup, and full-text search across Word, Excel, PowerPoint, PDF, and code files. It is intended for assistants working with files and content on a Windows PC.

Install WinShun from its latest Windows x64 release and use its built-in MCP capability with an AI assistant. The application targets Windows 10 and Windows 11. It also includes optional plugins and a separate community plugin library.

WinShun can search inside Word, Excel, PowerPoint, PDF, and code files. Content searches can be performed across the computer or limited to a selected folder, and results can display matching text and file details.

Yes, WinShun can search text recognized from copied images with OCR. Its clipboard history also retains copied text and supports image previews, including PNG, JPEG, and GIF content.

Cursor compatibility is not identified here. WinShun is presented as an MCP server for AI assistants, while the documented desktop requirements are Windows 10 or 11 on x64 hardware.

Related MCP servers

All in OS Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewWinShun AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/winshun?style=directory)](https://allmcps.com/mcp/winshun)
HTML Embed
<a href="https://allmcps.com/mcp/winshun"><img src="https://allmcps.com/api/badge/winshun?style=directory" alt="WinShun on AllMCPs" /></a>