效果如图：（Claude Code示例）

文本搜索（相似度语义搜索、全文搜索、混合搜索）

图片搜索

语音搜索

视频介绍

https://www.bilibili.com/video/BV14bfZBRE1k/

v1.4.0 版本更新说明

发布日期：2026年3月12日
版本类型：重大功能更新
主题：MCP 服务器支持

📋 版本概述

小遥搜索 v1.4.0 正式支持 Model Context Protocol (MCP)，可被 Claude Desktop 等 AI 应用连接，进行本地文件智能搜索。

核心亮点

🤖 MCP 协议支持：基于 Anthropic 官方 MCP 协议规范
🔌 Claude Desktop 集成：支持 Claude Desktop 直接搜索本地文件
⚡ 5 个搜索工具：语义搜索、全文搜索、语音搜索、图像搜索、混合搜索
🎯 FastAPI 集成架构：单一进程共享 AI 模型，节省 4-6GB 内存

✨ 新增功能

MCP 服务器支持

什么是 MCP？

MCP (Model Context Protocol) 是 Anthropic 推出的开源协议，允许 AI 应用（如 Claude Desktop）连接到本地数据源。通过 MCP，Claude 可以直接搜索和访问您的本地文件，提供更智能的问答和帮助。

支持的搜索工具：

工具名称	说明	AI 模型	优先级
semantic_search	语义搜索，支持自然语言查询理解	BGE-M3	P0
fulltext_search	全文搜索，支持精确关键词匹配和中文分词	Whoosh	P0
voice_search	语音搜索，支持语音输入转文本后搜索	FasterWhisper	P1
image_search	图像搜索，支持图片上传查找相似内容	CN-CLIP	P1
hybrid_search	混合搜索，结合语义和全文搜索的优势	BGE-M3 + Whoosh	P1

技术架构：

协议实现：使用 fastmcp 框架
传输方式：HTTP SSE (Server-Sent Events)
架构模式：FastAPI 集成，共享 AI 模型和搜索服务
内存优化：单一进程，模型只加载一次，节省 4-6GB 内存

📚 使用指南

MCP 客户端配置

小遥搜索 MCP 服务器使用 HTTP 传输协议，任何支持 HTTP MCP 的客户端都可以连接。

启动小遥搜索后端服务

确保小遥搜索后端服务正在运行（默认端口 8000）：

cd backend
python main.py

Claude Code CLI 配置

官方命令行工具，快速配置：

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaoyao-search http://127.0.0.1:8000/mcp

# 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）
claude mcp list

其他支持 MCP 的客户端

任何支持 MCP 协议的客户端都可以连接到：http://127.0.0.1:8000/mcp

基本配置模板：

{
  "name": "xiaoyao-search",
  "url": "http://127.0.0.1:8000/mcp",
  "type": "sse"
}

常用客户端配置示例：

Cline (VSCode 插件): 在 VSCode 设置中搜索 cline.mcpServers，添加上述配置
Cursor: 在 Cursor 设置的 MCP 服务器配置中添加上述配置
其他 MCP 客户端: 参考客户端文档，使用 SSE 传输方式连接

使用示例

配置完成后，您可以在 Claude Desktop 中进行以下操作：

语义搜索：

用户：帮我找一下关于异步编程的文档
Claude：[调用 semantic_search 工具] 找到 5 个相关文档...

全文搜索：

用户：搜索包含 "async def" 的代码文件
Claude：[调用 fulltext_search 工具] 找到 3 个代码文件...

图像搜索：

用户：[上传图片] 找找类似的图表
Claude：[调用 image_search 工具] 找到 2 个相似的图表...

验证 MCP 连接

访问健康检查端点验证 MCP 服务状态：

curl http://127.0.0.1:8000/mcp/health

返回示例：

{
  "status": "enabled",
  "server": "fastmcp",
  "tools_count": 5,
  "tools": ["semantic_search", "fulltext_search", "voice_search", "image_search", "hybrid_search"]
}