MCP文件搜索服务器
一种模型上下文协议（MCP）服务器，提供用于在文本文件中搜索关键字的文件搜索工具。使用TypeScript和Node.js构建。
描述
此MCP服务器实现了 search_file 该工具允许AI应用程序在文件中搜索特定关键字，并返回与其行号匹配的行。服务器支持区分大小写和不区分大小写的搜索选项。
特性
- 🔍 在文本文件中搜索关键字
- 📍 返回具有行号的匹配行
- 🔤 区分大小写和不区分大小写的搜索模式
- ⚡ 使用TypeScript构建类型安全
- 🔌 与MCP协议兼容
先决条件
- Node.js（v14或更高版本）
- npm或纱线
安装
- 克隆存储库：
git clone
cd mcp-file-search- 安装依赖项：
npm install- 构建项目：
npm run build用法
运行服务器
服务器使用STDIO传输进行通信： 节点构建/index.js
MCP检验员测试
- 启动MCP检查器：
npx @modelcontextprotocol/inspector node build/index.js- 在浏览器中打开提供的URL
- 点击“连接”连接到服务器
- 导航到“工具”选项卡以查看
search_file工具
- 使用以下参数测试工具：
- 关键词: "MCP" （或任何搜索词） - 文件路径: "sample.txt" （或任何文本文件的路径） - 区分大小写: false （可选，默认为false）
刀具参数
这 search_file 工具接受以下参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 关键字 | 字符串 | 是 | 要在文件中搜索的关键字 |
| filePath | string | Yes | 要搜索的文件的路径（绝对或相对） |
| caseSensitive | boolean | 否 | 搜索是否应区分大小写（默认值：false） |
发展
可用脚本
npm run build-将TypeScript编译为JavaScriptnpm run watch-注意更改并重新编译npm run inspector-运行MCP检查器进行测试
从源头构建
npm run build编译后的输出将在 build/ 目录。
依赖项
@modelcontextprotocol/sdk-用于构建服务器的MCP SDKzod-架构验证typescript-TypeScript编译器
错误处理
服务器包括以下错误处理：
- 找不到文件错误
- 文件路径无效
- 读取权限错误
- 参数类型无效
故障排除
故障排除
问题: ENOENT: no such file or directory
解决方案：确保使用正确的文件路径。请尝试使用绝对路径，或确保文件存在于指定位置。
问题：MCP检查器中的连接错误
解决方案：确保服务器已构建(npm run build)Arguments字段中的路径为 build/index.js.
问题: Command not found
解决方案：使用以下命令从项目目录运行检查器 npx @modelcontextprotocol/inspector node build/index.js.