小遥搜索v1.4.0版本更新【已支持-MCP协议】

dtsola
0 阅读3分钟

效果如图：（Claude Code示例）

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

图片搜索

语音搜索

视频介绍

www.bilibili.com/video/BV14b…

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-M3P0
fulltext_search全文搜索，支持精确关键词匹配和中文分词WhooshP0
voice_search语音搜索，支持语音输入转文本后搜索FasterWhisperP1
image_search图像搜索，支持图片上传查找相似内容CN-CLIPP1
hybrid_search混合搜索，结合语义和全文搜索的优势BGE-M3 + WhooshP1

技术架构：

  • 协议实现：使用 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"]
}

📦 下载地址

🙏 致谢

感谢以下开源项目的支持：

让我们一起打造更好的本地搜索体验！ 🚀

#独立开发者 #知识工作者 #知识库 #AI工具 #内容创作者 #一人公司 #ai搜索 #dify #ragflow #vibecoding

avatar
文章
阅读
粉丝