AI导哈

文件系统管理服务

一个为AI助手提供安全文件系统操作的MCP服务器，适用于Claude Code等场景。

  • by andrewlidong
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 andrewlidong/filesystem-explorer-mcp

使用说明

文件系统资源管理器MCP服务器

一个模型上下文协议（MCP）服务器，为AI助手提供安全的文件系统操作，非常适合与Claude Code一起使用。

特性

  • 安全浏览文件：出于安全考虑，仅限于根目录
  • 文件读取：通过自动语言检测读取文本文件
  • 元数据分析：获取详细的文件和目录信息
  • 文件搜索：按模式或扩展名查找文件
  • 项目分析：分析项目结构和使用的语言
  • 安全控制：文件大小限制、扩展名筛选、目录限制

安装

npm install

用法

# Start the server with default configuration
npm start

# Start the server with custom configuration
ROOT_DIR=/path/to/directory PORT=4000 npm start

环境变量

  • PORT：运行服务器的端口（默认值：3000）
  • ROOT_DIR：提供文件的根目录（默认：当前工作目录）

API方法

list目录

列出指定路径中的文件和目录。

{
  "path": "src"
}

readFile

通过语言检测读取文件内容。

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

getMetadata

获取文件或目录的元数据。

{
  "path": "package.json"
}

搜索文件

搜索与模式匹配的文件。

{
  "pattern": "\\.ts$",
  "directory": "src"
}

获取项目信息

获取有关项目结构的概述信息。

{}

存在

检查文件或目录是否存在。

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

安全考虑

  • 所有路径都经过规范化和检查，以防止目录遍历攻击
  • 默认情况下，最大文件大小限制为10MB
  • 只能读取允许的文件扩展名
  • 所有操作仅限于指定的根目录

许可证

国际协调委员会

相关 MCP