
mcp/filesystem提供支持可配置允许路径的本地文件系统访问。
什么是MCP服务器?
| 属性 | 详情 |
|---|---|
| Docker镜像 | mcp/filesystem |
| 作者 | modelcontextprotocol |
| 代码仓库 | [***] |
| Dockerfile | [***] |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout Health Score |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/filesystem --key [***] |
| 许可证 | MIT许可证 |
| 本服务器提供的工具 | 简短描述 |
|---|---|
create_directory | 创建新目录或确保目录存在。 |
directory_tree | 以JSON结构获取文件和目录的递归树形视图。 |
edit_file | 对文本文件进行基于行的编辑。 |
get_file_info | 检索文件或目录的详细元数据。 |
list_allowed_directories | 返回本服务器允许访问的目录列表。 |
list_directory | 获取指定路径下所有文件和目录的详细列表。 |
move_file | 移动或重命名文件和目录。 |
read_file | 从文件系统读取文件的完整内容。 |
read_multiple_files | 同时读取多个文件的内容。 |
search_files | 递归搜索匹配模式的文件和目录。 |
write_file | 创建新文件或用新内容完全覆盖现有文件。 |
create_directory创建新目录或确保目录存在。可在一次操作中创建多个嵌套目录。若目录已存在,操作将静默成功。适用于设置项目目录结构或确保所需路径存在。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
path | string | 目录路径 |
directory_tree以JSON结构获取文件和目录的递归树形视图。每个条目包含'name'(名称)、'type'(类型:file/directory)和目录的'children'(子项)。文件无children数组,目录始终有children数组(可能为空)。输出采用2空格缩进格式以提高可读性。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
path | string | 目录路径 |
edit_file对文本文件进行基于行的编辑。每次编辑用新内容替换精确的行序列。返回git风格的差异以显示所做更改。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
edits | array | 编辑操作数组 |
path | string | 文件路径 |
dryRun | boolean 可选 | 使用git风格差异格式预览更改 |
get_file_info检索文件或目录的详细元数据。返回包括大小、创建时间、最后修改时间、权限和类型的综合信息。此工具适用于了解文件特性而无需读取实际内容。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
path | string | 文件或目录路径 |
list_allowed_directories返回本服务器允许访问的目录列表。使用此工具可在尝试访问文件前了解可用目录。
list_directory获取指定路径下所有文件和目录的详细列表。结果用[FILE]和[DIR]前缀明确区分文件和目录。此工具对于了解目录结构和查找目录内特定文件至关重要。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
path | string | 目录路径 |
move_file移动或重命名文件和目录。可在一次操作中在目录间移动文件或重命名。若目标已存在,操作将失败。可跨不同目录工作,也可用于同一目录内的简单重命名。源和目标必须均在允许的目录内。
| 参数 | 类型 | 描述 |
|---|---|---|
destination | string | 目标路径 |
source | string | 源路径 |
read_file从文件系统读取文件的完整内容。处理各种文本编码,若文件无法读取则提供详细错误消息。当需要检查单个文件内容时使用此工具。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
path | string | 文件路径 |
read_multiple_files同时读取多个文件的内容。当需要分析或比较多个文件时,此工具比逐个读取更高效。每个文件的内容与其路径一起返回。单个文件读取失败不会终止整个操作。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
paths | array | 文件路径数组 |
search_files递归搜索匹配模式的文件和目录。从起始路径搜索所有子目录。搜索不区分大小写且匹配部分名称。返回所有匹配项的完整路径。适用于不知道文件确切位置时查找文件。仅在允许的目录内搜索。
| 参数 | 类型 | 描述 |
|---|---|---|
path | string | 起始路径 |
pattern | string | 搜索模式 |
excludePatterns | array 可选 | 排除模式数组 |
write_file创建新文件或用新内容完全覆盖现有文件。使用时需谨慎,因为它会无警告地覆盖现有文件。以正确编码处理文本内容。仅在允许的目录内工作。
| 参数 | 类型 | 描述 |
|---|---|---|
content | string | 文件内容 |
path | string | 文件路径 |
json{ "mcpServers": { "filesystem": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/local-directory:/local-directory", "mcp/filesystem", "/local-directory" ] } } }
为什么使用Docker运行MCP服务器更安全?






探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像服务
在 Docker Desktop 配置镜像
Docker Compose 项目配置
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
在宝塔面板一键配置镜像
Synology 群晖 NAS 配置
飞牛 fnOS 系统配置镜像
极空间 NAS 系统配置服务
爱快 iKuai 路由系统配置
绿联 NAS 系统配置镜像
QNAP 威联通 NAS 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等;免费版仅支持 docker.io。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
来自真实用户的反馈,见证轩辕镜像的优质服务