文件系统MCP服务器
使用FastMCP构建的功能强大的文件系统管理服务器，为文件和目录操作提供了一套全面的工具。该服务器允许您通过结构化的API执行各种文件系统操作，使其成为自动化和与其他系统集成的理想选择。
平台支持
该服务器旨在跨不同的操作系统工作，但功能级别各不相同：
视窗
- 全功能支持
- 驱动器列表
- 特殊文件夹访问
- Windows特定路径处理
- 详细的系统信息
macOS/Linux
- 基本文件操作
- 目录操作
- 文件搜索和元数据
- 系统基本信息
- 注意：某些特定于Windows的功能不可用
未来实施
计划中的macOS支持
- macOS的原生路径处理
- macOS特定系统信息检索
- 与macOS文件系统功能集成
- 支持macOS特定的文件属性
- macOS特定实用程序的实现（类似于windows_utils.py）
计划中的Linux支持
- Linux的本机路径处理
- Linux特定系统信息检索
- 与Linux文件系统功能集成
- 支持Linux文件权限和属性
- Linux特定实用程序的实现
跨平台改进
- 统一路径处理系统
- 与平台无关的驱动器检测
- 一致的系统信息API
- 跨平台的标准化文件属性
- 跨平台文件系统事件监控
- 通用文件收集系统
时间线
- 第一阶段：基本的跨平台兼容性改进
- 第2阶段：平台特定功能实现
- 第3阶段：高级跨平台功能
- 第4阶段：性能优化和改进
特性
文件操作
- 使用备份支持复制文件
- 使用备份支持移动文件
- 删除带有安全检查的文件
- 读取文件内容
- 写入文件内容
- 获取文件信息（大小、创建时间、修改时间）
- 按名称模式搜索文件
- 创建文件集合以组织相关文件
目录操作
- 列出目录内容
- 创建目录
- 删除目录
- 递归列出目录（树状结构）
- 按名称模式搜索目录
系统信息
- 获取系统信息（操作系统、CPU、内存、磁盘使用情况）
- 获取磁盘信息（总空间、已用空间、可用空间）
- 获取目录信息（文件数、总大小）
项目结构
file-system-mcp-server/
├── fs_server.py # Main server implementation
├── windows_utils.py # Windows-specific utilities (Windows only)
├── requirements.txt # Project dependencies
└── test_prompts_example.md # Example test prompts收藏存储
集合可以存储在用户指定的任何目录中。如果未指定存储位置，则集合将存储在项目的默认位置 data/collections 目录。
示例用法：
# Store in default location
create_collection("my_collection", ["file1.txt", "file2.txt"])
# Store in custom location
create_collection("my_collection", ["file1.txt", "file2.txt"], storage_path="/path/to/store")依赖项
所需依赖关系
- FastMCP
- 派丹蒂克
- pywin32（仅限Windows）
- WMI（仅限Windows）
要安装依赖项，请执行以下操作：
pip install -r requirements.txt设置
- 克隆存储库：
git clone https://github.com/calebmwelsh/file-system-mcp-server.git
cd file-system-mcp-server- 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate- 安装依赖项：
pip install -r requirements.txt用法
有关不同开发环境（Claude、Cursor、Windsurf）的详细MCP配置说明，请访问： MCP配置指南
与Claude整合
要将文件系统MCP服务器与Claude集成，请将以下内容添加到您的 claude_desktop_config.json 文件：
{
"mcpServers": {
"file-system": {
"command": "/absolute/path/to/python",
"args": [
"/absolute/path/to/file-system-mcp-server/fs_server.py"
]
}
}
}找到你的Python路径
要查找Python可执行路径，请使用以下命令：
Windows（PowerShell）：
(Get-Command python).SourceWindows（命令提示符/终端）：
where pythonLinux/macOS（终端）：
which python替换 /absolute/path/to/python 使用上述适当命令的输出。
配置示例
对于Windows，您的配置可能如下：
{
"mcpServers": {
"file-system": {
"command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python39\\python.exe",
"args": [
"C:\\Users\\YourUsername\\Documents/file-system-mcp-server/fs_server.py"
]
}
}
}对于macOS/Linux：
{
"mcpServers": {
"file-system": {
"command": "/usr/local/bin/python3",
"args": [
"/Users/YourUsername/Documents/file-system-mcp-server/fs_server.py"
]
}
}
}添加配置后：
- 保存
claude_desktop_config.json文件 - 重新启动克劳德
- 现在，您可以通过要求Claude执行文件操作来使用文件系统工具
可用工具
文件操作
copy_file：复制带有可选备份的文件move_file：使用可选备份移动文件delete_file：删除带有安全检查的文件read_file：读取文件内容write_file：将内容写入文件get_file_info：获取详细的文件信息search_files：按名称模式搜索文件create_collection：创建文件集合
目录操作
list_directory：列出目录内容create_directory：创建新目录delete_directory：删除目录list_directory_recursively：以树格式显示目录结构search_directories：按名称模式搜索目录
系统信息
get_system_info：获取系统信息get_disk_info：获取磁盘使用信息get_directory_info：获取目录统计信息
已知问题
以下功能当前遇到问题，可能无法按预期工作：
- 删除文件功能
- 这 delete_file 在某些情况下，函数可能无法正确删除文件 - 建议用户手动验证文件删除，或在关键时使用其他方法 - 问题正在调查中，将在未来的更新中得到解决
- 列表驱动器功能
- 这 list_drives 功能可能无法正确检测或显示所有可用驱动器 - 列表中可能缺少某些驱动器或显示不正确的信息 - 这是一个已知的限制，将在未来的更新中加以解决
- 平台特定限制
- Windows特定功能在macOS/Linux上不可用 - 某些路径处理可能因平台而异 - 系统信息检索因平台而异
错误处理
该服务器包括全面的错误处理功能，用于：
- 文件路径无效
- 找不到文件/目录
- 权限问题
- 磁盘空间限制
- 无效操作
- 平台特定错误
安全
- 所有文件操作都包括路径验证
- 在破坏性操作之前创建备份文件
- 系统信息访问仅限于安全操作
- 文件操作是通过适当的错误处理来执行的
贡献
- 分叉存储库
- 创建要素分支
- 提交您的更改
- 推到分支
- 创建拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
致谢
- 使用FastMCP构建
- 使用Pydantic进行数据验证
- 受现代文件系统管理工具的启发
