使用说明
MCP文件系统服务器
提供安全文件系统操作的模型上下文协议（MCP）服务器。
特性
- ✅ 读取文件
- ✅ 写入/创建文件
- ✅ 删除文件
- ✅ 列出目录内容
- ✅ 创建目录
- ✅ 删除目录
- ✅ 移动/重命名文件和目录
- ✅ 获取文件/目录信息
- 🔒 路径遍历保护
安装
- 克隆存储库
- 创建虚拟环境：
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- 安装依赖项：
pip install -r requirements.txt
用法
运行服务器：
python src/server.py
服务器将在以下位置创建一个工作区目录 ~/mcp_workspace 其中所有文件操作都有作用域。
配置
要更改基本目录，请修改 BASE_DIR 变量in src/server.py:
BASE_DIR = Path.home() / "mcp_workspace" # Change this path
可用工具
read_file
读取文件的内容。
- 参数:
path（字符串）
write_file
将内容写入文件（创建或覆盖）。
- 参数:
path（字符串），content（字符串）
删除文件
删除文件。
- 参数:
path（字符串）
list_directory
列出目录的内容。
- 参数:
path（字符串，可选）
create_directory
创建一个新目录。
- 参数:
path（字符串）
delete_directory
删除目录及其内容。
- 参数:
path（字符串）
move_item
移动或重命名文件或目录。
- 参数:
source（字符串），destination（字符串）
获取_文件_信息
获取有关文件或目录的信息。
- 参数:
path（字符串）
安全
所有文件操作都限制在配置的基目录中，以防止目录遍历攻击。
测试
运行测试：
pytest tests/
许可证
麻省理工学院
