智能文件搜索服务

智能搜索MCP服务器

一种模型上下文协议（MCP）服务器，提供智能文件搜索功能，在找不到精确匹配时，提供精确的关键字匹配和语义相似性建议。

特性

• 精确关键字匹配：在文件中搜索完全匹配的关键字
• 位置跟踪：返回所有匹配项的行号和字符位置
• 比赛计数：提供关键字出现的总数
• 语义搜索：当没有找到完全匹配的单词时，使用嵌入模型来建议语义上最相似的前5个单词
• 案例不敏感搜索：无论何种情况，都能灵活匹配

安装

1. 克隆此存储库
2. 安装依赖项：

pip install -r requirements.txt

用法

启动服务器

python server.py

工具：智能搜索

参数：

• file_path （string，必填）：要搜索的文件的路径
• keyword （字符串，必填）：要搜索的关键字

行为：

1. 找到精确匹配：返回所有匹配项：

   • 行号
   • 角色位置
   • 线路内容
   • 总数

2. 没有完全匹配：返回语义上最相似的前5个单词：

   • 在文件中发现了类似的单词
   • 相似性得分（0-1）
   • 行号和内容

例子：

启动MCP检查器

运行下面的cmd启动MCP检查器。这将在浏览器中打开。

npx @modelcontextprotocol/inspector python3 server.py

演示截图

在Inspector中选择smart_search MCP工具

找到完全匹配的示例

语义回退：不匹配-返回相似单词

*在《美女与野兽》中寻找铁人，一无所获。 *

👤 作者

Pranjal Chaubey