Xiaoyao Search
小遥搜索，听懂你的话、看懂你的图，用AI找到本地任何文件。让搜索像聊天一样简单。XiaoyaoSearch: Understands your words, reads your images, finds any local file with AI. Making search as easy as chatting.
What is Xiaoyao Search?
Xiaoyao Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 小遥搜索，听懂你的话、看懂你的图，用ai找到本地任何文件。让搜索像聊天一样简单。xiaoyaosearch: understands your words, reads your images, finds any local file with ai. making search as easy as chatting.
小遥搜索，听懂你的话、看懂你的图，用AI找到本地任何文件。让搜索像聊天一样简单。XiaoyaoSearch: Understands your words, reads your images, finds any local file with AI. Making search as easy as chatting.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 小遥搜索，听懂你的话、看懂你的图，用AI找到本地任何文件。让搜索像聊天一样简单。XiaoyaoSearch: Under
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx xiaoyaosearchConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Xiaoyao Search
XiaoYao Search is a locally-hosted AI-powered file search engine that understands natural language queries and can even analyze images to find matching files on your computer. It combines semantic search (via BGE-M3 embeddings), full-text keyword search (via Whoosh), voice input (via FasterWhisper), and visual similarity matching (via CN-CLIP) into a single hybrid search system. Developers and power users connect to it through an MCP SSE endpoint, allowing Claude or other AI assistants to invoke local file searches as tool calls.
Prerequisites
- Python 3.10+ with pip for the backend service
- Node.js 18+ for the frontend (optional UI)
- An MCP client such as Claude Desktop that supports SSE transport
- Sufficient local disk space to store FAISS vector indexes and Whoosh full-text indexes
- Optional: microphone access and GPU for faster embeddings
Clone the repository
Clone the XiaoYao Search repository from GitHub to get both the backend and frontend source code.
git clone https://github.com/dtsola/xiaoyaosearch.git
cd xiaoyaosearchInstall Python backend dependencies
Install the required Python packages including vector search libraries, the Whoosh indexer, and FasterWhisper for voice input support.
cd backend
pip install -r requirements.txt
pip install faster-whisperConfigure environment variables
Create a .env file in the backend directory to set paths for the FAISS vector index, Whoosh full-text index, SQLite database, and to enable MCP SSE support.
FAISS_INDEX_PATH=../data/indexes/faiss
WHOOSH_INDEX_PATH=../data/indexes/whoosh
DATABASE_PATH=../data/database/xiaoyao_search.db
API_HOST=127.0.0.1
API_PORT=8000
MCP_SSE_ENABLED=trueStart the backend server
Launch the Python backend which starts the MCP SSE endpoint at http://127.0.0.1:8000/mcp. The first run will build search indexes from your files.
python main.pyConfigure your MCP client
Add XiaoYao Search to your Claude Desktop (or other MCP client) configuration using the SSE transport type pointing to the running backend.
{
"mcpServers": {
"xiaoyaosearch": {
"type": "sse",
"url": "http://127.0.0.1:8000/mcp"
}
}
}Xiaoyao Search Examples
Client configuration
SSE-based MCP client configuration for Claude Desktop pointing to the local XiaoYao Search backend.
{
"mcpServers": {
"xiaoyaosearch": {
"type": "sse",
"url": "http://127.0.0.1:8000/mcp"
}
}
}Prompts to try
Example natural language queries you can send to Claude once XiaoYao Search is connected.
- "Find documents about async programming on my computer"
- "Search for files containing the keyword 'budget 2024'"
- "Find images that look similar to my landscape photo"
- "Locate any PDF files I created last month related to the project proposal"Troubleshooting Xiaoyao Search
MCP client cannot connect to the SSE endpoint
Ensure MCP_SSE_ENABLED=true is set in your .env file and the backend is running. Verify the backend is listening on port 8000 with: curl http://127.0.0.1:8000/mcp
Search returns no results after startup
The FAISS and Whoosh indexes must be built before searching. Trigger an index rebuild from the UI or by running the indexing script manually. Check that FAISS_INDEX_PATH and WHOOSH_INDEX_PATH point to writable directories.
Voice search fails or produces poor transcriptions
Ensure faster-whisper is installed and your microphone is accessible. Try changing the whisper model size in config (e.g. 'small' for speed vs 'medium' for accuracy). On macOS you may need to grant microphone permissions to the terminal.
Frequently Asked Questions about Xiaoyao Search
What is Xiaoyao Search?
Xiaoyao Search is a Model Context Protocol (MCP) server that 小遥搜索，听懂你的话、看懂你的图，用ai找到本地任何文件。让搜索像聊天一样简单。xiaoyaosearch: understands your words, reads your images, finds any local file with ai. making search as easy as chatting. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Xiaoyao Search?
Follow the installation instructions on the Xiaoyao Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Xiaoyao Search?
Xiaoyao Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Xiaoyao Search free to use?
Yes, Xiaoyao Search is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Xiaoyao Search Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Xiaoyao Search? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Xiaoyao Search in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Xiaoyao Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.