File Search MCP

基于Rust和Tantivy的本地文件全文搜索MCP服务器

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:File Search MCP。
它的用途是:基于Rust和Tantivy的本地文件全文搜索MCP服务器
完整的 Skill 内容见:https://321skill.com/skills/file-search-mcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请在我的‘项目文档’文件夹里搜索所有提到‘用户认证’的段落。”,它会通过File Search MCP服务器快速索引并返回包含该关键词的所有文件及上下文。或者,当你忘记某个函数定义在哪时,可以说:“在src目录下全文搜索‘calculateRevenue’这个函数。”

介绍

这个Skill解决的是在本地文件系统中快速、精准地查找包含特定关键词或内容的文件难题。传统文件搜索往往依赖文件名或简单内容匹配,效率低下且无法进行复杂的语义或全文检索。

通过集成Tantivy搜索引擎库,该MCP服务器为你的AI助手(如Claude)提供了强大的本地文件索引与查询能力。安装后,AI可以直接在你的项目目录或指定文件夹中执行全文搜索,快速定位代码片段、文档段落或配置文件。

它特别适合需要频繁查阅和梳理本地文档、代码库的开发者、研究员和内容创作者。无论是查找一个模糊记忆的函数定义,还是在大量笔记中定位某个概念,都能显著提升效率。

建议在初次使用时,先对核心工作目录建立索引。注意,这是一个本地搜索工具,索引和查询都在你的机器上完成,不涉及云端数据传输,但需要确保有足够的磁盘空间存放索引文件。

核心特点

核心区别在于其底层使用Rust编写的高性能Tantivy搜索引擎,相比其他基于简单文本匹配的搜索工具,它提供了更快速、更精准的全文检索能力。同时,它专为MCP协议设计,能与Claude等AI助手深度集成,实现自然语言驱动的智能文件查找。

注意事项

不适合需要实时同步云端文件或跨网络进行搜索的场景。

常见问题

这个工具能搜索哪些类型的文件?

主要支持文本文件,如代码文件(.py, .js, .md等)、配置文件、日志文件、文档(.txt)等,具体取决于配置的索引规则。

搜索速度如何?索引会占用很多空间吗?

搜索速度极快,得益于Tantivy引擎。索引文件大小通常远小于原始文件集合,占用空间可控。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/file-search-mcp/raw/index.md 读取 File Search MCP 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。