文件系统资源管理器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
- 只能读取允许的文件扩展名
- 所有操作仅限于指定的根目录
许可证
国际协调委员会
