AI导哈

高级文件搜索服务

Ressl MCP Server是一款提供强大文件搜索功能的Model Context Protocol服务器，支持单文件搜索、目录递归搜索、文件元数据获取等功能，适用于Claude Desktop等MCP兼容客户端。

  • by DataCleaninghash
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 DataCleaninghash/ressl-mcp-file-search

使用说明

Ressl MCP服务器-高级文件搜索

一个复杂的模型上下文协议（MCP）服务器，为Claude Desktop和其他兼容MCP的客户端提供强大的文件搜索功能。

特性

  • 单个文件搜索：使用行号在单个文件中搜索关键字
  • 目录搜索：使用扩展名过滤在整个目录中递归搜索
  • 文件信息：获取有关文件的详细元数据（大小、行数、修改日期）
  • 高级选项：区分大小写的搜索、自定义结果限制、可配置的格式
  • 错误处理：全面的错误处理，信息清晰
  • 演出：高效的基于正则表达式的搜索，具有结果限制

安装

  1. 克隆此存储库：
git clone <your-repo-url>
cd ressl-mcp-server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

Claude桌面配置

将以下内容添加到您的Claude Desktop配置文件中：

视窗: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fileSearch": {
      "command": "node",
      "args": [
        "C:\\path\\to\\ressl-mcp-server\\dist\\index.js"
      ]
    }
  }
}

确保用实际的项目路径替换路径。

可用工具

1.搜索_文件

在单个文件中搜索关键字。

参数：

  • filePath （必填）：要搜索的文件的路径
  • keyword （必填）：要搜索的关键字或模式
  • caseSensitive （可选）：区分大小写的搜索（默认值：false）
  • includeLineNumbers （可选）：包括行号（默认值：true）
  • maxResults （可选）：返回的最大结果数（默认值：100）

例子：

{
  "filePath": "./src/index.ts",
  "keyword": "function",
  "caseSensitive": false,
  "maxResults": 50
}

2.搜索目录

在目录中的所有文件中递归搜索关键字。

参数：

  • directoryPath （必填）：目录路径
  • keyword （必填）：要搜索的关键字或模式
  • fileExtensions （可选）：要过滤的扩展数组，例如[“ts”，“js”]
  • caseSensitive （可选）：区分大小写的搜索（默认值：false）
  • includeLineNumbers （可选）：包括行号（默认值：true）
  • maxResults （可选）：返回的最大结果数（默认值：500）

例子：

{
  "directoryPath": "./src",
  "keyword": "class",
  "fileExtensions": ["ts", "js"],
  "maxResults": 100
}

3.获取_文件_信息

获取文件的详细信息。

参数：

  • filePath （必填）：文件路径

例子：

{
  "filePath": "./src/index.ts"
}

使用示例

示例1：在单个文件中搜索

在主服务器文件中搜索所有出现的“搜索”：

{
  "filePath": "./src/index.ts",
  "keyword": "search",
  "includeLineNumbers": true
}

示例2：跨项目文件搜索

查找所有包含“async”的TypeScript文件：

{
  "directoryPath": "./src",
  "keyword": "async",
  "fileExtensions": ["ts"],
  "maxResults": 200
}

示例3：获取文件统计信息

检索特定文件的信息：

{
  "filePath": "./README.md"
}

发展

# Development mode with watch
npm run dev

# Build for production
npm run build

# Start the server
npm start

MCP检验员测试

您可以使用MCP检查器测试服务器：

npx @modelcontextprotocol/inspector node dist/index.js

项目结构

ressl-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled JavaScript (generated)
├── examples/             # Example files for testing
├── package.json
├── tsconfig.json
└── README.md

技术细节

  • 语言：TypeScript
  • 运行时：Node.js 18+
  • 框架：MCP SDK v0.5.0
  • 模式匹配：基于正则表达式的特殊字符转义
  • 文件处理：带错误恢复的UTF-8编码
  • 演出：高效流式传输大文件

错误处理

服务器为以下对象提供明确的错误消息：

  • 文件未找到
  • 路径无效
  • 权限问题
  • 超出结果限制

许可证

麻省理工学院

作者

Shweta Patel

相关 MCP