本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

提供支持可配置允许路径的本地文件系统访问。
什么是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 | 文件路径 |
{ "mcpServers": { "filesystem": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/local-directory:/local-directory", "mcp/filesystem", "/local-directory" ] } } }
为什么使用Docker运行MCP服务器更安全?
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429