xTag

Overview

Full name
docker.io/mcp/filesystem
Registry
docker.io
Namespace
mcp
Repository
filesystem
Cached tags
3
Last synced
07/06/2026, 03:13 PM

Introduction

Docker MCP Filesystem 服务器镜像，为 Cursor/Claude Agent 提供受控本地文件读写能力，经 MCP 协议暴露 list/read/write 工具，适合 Sidecar 或独立微服务。

Details

mcp/filesystem 实现 Model Context Protocol 的文件系统工具集，Agent 在沙箱路径内列举目录、读取与写入文本文件，避免直接挂载主机全盘。镜像轻量、无持久化需求，通常与 IDE Agent 同机或同 Pod 部署。与通用 busybox 相比协议层标准化；生产应固定 tag、通过 ALLOWED_PATHS 或 volume 限定可访问目录，防止路径穿越与 SSRF 式文件泄露。

快速启动

docker run -d --name mcp-filesystem \
  -p 3000:3000 \
  -v $(pwd)/workspace:/workspace:ro \
  docker.io/mcp/filesystem:latest

推荐实践

docker run -d --name mcp-filesystem \
  --restart unless-stopped \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e ALLOWED_PATHS=/workspace \
  -v /data/agent-workspace:/workspace:ro \
  docker.io/mcp/filesystem:latest

核心参数说明

  • -p 3000:3000 — MCP SSE/HTTP 监听端口
  • -e MCP_TRANSPORT=sse — Server-Sent Events 传输模式
  • -e ALLOWED_PATHS — 允许 Agent 访问的根路径
  • -v .../workspace:/workspace:ro — 只读挂载工作区
  • --restart unless-stopped — Agent 工具持续在线
  • 安全 — 禁止挂载 / 或 docker.sock

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-filesystem
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mcp-filesystem
  template:
    metadata:
      labels:
        app: mcp-filesystem
    spec:
      containers:
        - name: filesystem
          image: docker.io/mcp/filesystem:latest
          ports:
            - containerPort: 3000
          env:
            - name: ALLOWED_PATHS
              value: /workspace
          volumeMounts:
            - name: workspace
              mountPath: /workspace
              readOnly: true
      volumes:
        - name: workspace
          persistentVolumeClaim:
            claimName: agent-workspace
---
apiVersion: v1
kind: Service
metadata:
  name: mcp-filesystem
spec:
  selector:
    app: mcp-filesystem
  ports:
    - port: 3000
      targetPort: 3000

PVC 或 ConfigMap 限定工作区；NetworkPolicy 限制仅 Agent Pod 可访问。

Latest tags (20)

View all 3 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/mcp/filesystem
:1.0.2
linux/arm64linux/amd64
2025/09/10 04:3360.3 MBsha256:262b37f3ebca…
docker.io/mcp/filesystem
:mcp-server
-2025/08/14 12:11--
docker.io/mcp/filesystem
:latest
linux/amd64linux/arm64
2025/06/17 03:2157.1 MBsha256:e6745cfe1477…