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/许可证
麻省理工学院
