Ressl MCP File Search

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

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

特性

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

安装

1. 克隆此存储库：

git clone 
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