基本能力
产品定位
MCP File System Server 是一个文件系统操作服务器，旨在为 AI 助手提供对本地文件系统的安全访问能力，支持开发者在项目中进行高效的代码管理和协作。
核心功能
list_directory: 列出项目目录中的文件和目录read_file: 读取文件内容save_file: 原子性地写入文件内容append_file: 追加内容到文件末尾delete_this_file: 删除指定文件edit_file: 使用模式匹配进行选择性编辑- 结构化日志记录：支持人类可读和 JSON 格式的日志
适用场景
- AI 助手协助代码生成和修改
- 项目文件管理和组织
- 代码调试和修复
- 自动化文件操作
工具列表
| 工具名称 | 描述 |
|----------|------|
| list_directory | 列出项目目录中的文件和目录 |
| read_file | 读取文件内容 |
| save_file | 创建或覆盖文件 |
| append_file | 追加内容到现有文件 |
| delete_this_file | 删除文件 |
| edit_file | 使用模式匹配进行选择性编辑 |
常见问题解答
- 如何确保文件操作的安全性？
所有路径都经过规范化验证，确保不超出项目目录范围。 - 如何集成到 VSCode？
需要配置 Cline 扩展的 MCP 服务器设置文件。 - 如何调试服务器？
可以使用 MCP Inspector 工具进行调试。
使用教程
使用依赖
- 确保已安装 Python 和 Git
- 创建并激活虚拟环境（推荐）
安装教程
```bash
克隆仓库
git clone https://github.com/MarcusJellinghaus/mcp_server_filesystem.git
cd mcp-server-filesystem
创建并激活虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
安装依赖
pip install -e .
```
调试方式
```bash
运行服务器
python -m src.main --project-dir /path/to/project --log-level DEBUG
使用 MCP Inspector 调试
npx @modelcontextprotocol/inspector uv --directory C:\path\to\mcp_server_filesystem run src\main.py
```
