No recent activity. No commits in 6 months. It may still work, but issues are unlikely to be fixed. See 4 alternatives.

Dev Tools & GitMCP Registrynpm34 toolsB · 61

mcp-filesystem

Name: mcp-filesystem
Author: Digital-Defiance

io.github.Digital-Defiance · Updated 10mo ago

Advanced filesystem operations with strict security boundaries for AI agents

At a glance

mcp-filesystem is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y @ai-capabilities-suite/mcp-filesystem`, and needs WORKSPACE_ROOT. It exposes 34 tools, including screenshot_capture_full, screenshot_capture_window and screenshot_capture_region. It scores B (61/100) on the MCP Skills Hub health score as of Oct 27, 2026.

Source 3

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install mcp-filesystem in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install mcp-filesystem in Claude CodeAnthropic's agentic CLI

Add the server

bash

claude mcp add mcp-filesystem -e 'WORKSPACE_ROOT=<WORKSPACE_ROOT>' -- npx -y @ai-capabilities-suite/mcp-filesystem

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.
3
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. screenshot_capture_full, screenshot_capture_window, screenshot_capture_region). It discovers them automatically.

How to install mcp-filesystem in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-capabilities-suite/mcp-filesystem"
      ],
      "env": {
        "WORKSPACE_ROOT": "<WORKSPACE_ROOT>"
      }
    }
  }
}

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install mcp-filesystem in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-capabilities-suite/mcp-filesystem"
      ],
      "env": {
        "WORKSPACE_ROOT": "<WORKSPACE_ROOT>"
      }
    }
  }
}

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install mcp-filesystem in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.mcp-filesystem]
command = "npx"
args = ["-y", "@ai-capabilities-suite/mcp-filesystem"]
env = { WORKSPACE_ROOT = "<WORKSPACE_ROOT>" }

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install mcp-filesystem in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-capabilities-suite/mcp-filesystem"
      ],
      "env": {
        "WORKSPACE_ROOT": "<WORKSPACE_ROOT>"
      }
    }
  }
}

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install mcp-filesystem in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-capabilities-suite/mcp-filesystem"
      ],
      "env": {
        "WORKSPACE_ROOT": "<WORKSPACE_ROOT>"
      }
    }
  }
}

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.

How to install mcp-filesystem in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "servers": {
    "mcp-filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ai-capabilities-suite/mcp-filesystem"
      ],
      "env": {
        "WORKSPACE_ROOT": "<WORKSPACE_ROOT>"
      }
    }
  }
}

Fill in your credentials
Replace <WORKSPACE_ROOT> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What does mcp-filesystem need from you?

Configuration only — Declares config values but no credentials.

WORKSPACE_ROOTrequiredEnvironment variable
Absolute path to workspace directory (all operations confined here)

Pass secrets through your shell environment rather than committing them into a config file.

What tools does mcp-filesystem expose? (34)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

screenshot_capture_fullCapture entire screen with format options (PNG, JPEG, WebP, BMP)
screenshot_capture_windowCapture specific application windows by title or ID
screenshot_capture_regionCapture rectangular screen regions with precise boundaries
screenshot_list_displaysList connected displays with resolutions and scaling
screenshot_list_windowsList visible windows with titles, positions, and dimensions
fs_batch_operationsExecute multiple operations atomically with rollback
fs_watch_directoryMonitor directories for real-time changes
fs_get_watch_eventsRetrieve accumulated filesystem events
fs_stop_watchStop watch sessions and clean up resources
fs_search_filesSearch by name, content, or metadata
fs_build_indexBuild searchable index for fast searching
fs_create_symlinkCreate symbolic links within workspace
fs_compute_checksumCompute file checksums for integrity verification
fs_verify_checksumVerify file checksums match expected values
fs_analyze_disk_usageAnalyze disk usage and identify large files
fs_copy_directoryRecursively copy directories with options
fs_sync_directorySync directories by copying only newer/missing files
process_startLaunch processes with arguments, environment, and resource limits
process_terminateGraceful or forced termination with timeout escalation
process_get_statsReal-time CPU, memory, thread, and I/O statistics
process_send_stdinSend input to interactive processes
process_get_outputRetrieve captured stdout and stderr
process_listList all managed processes with status
process_get_statusDetailed process state and uptime
process_create_groupCreate process groups and pipelines
process_add_to_groupAdd processes to groups
process_terminate_groupTerminate all processes in a group
process_start_serviceStart long-running services with auto-restart
process_stop_serviceStop services and disable auto-restart
mcp-debugger25+ debugging tools with performance profiling, hang detection, advanced breakpoints
mcp-screenshotScreenshot capture with multiple formats (PNG, JPG, WebP)
mcp-processProcess management with enterprise security
mcp-recordingScreen recording with video encoding and frame extraction - Planned
mcp-filesystemAdvanced file operations beyond basic read/write - Planned

What the code can do

Read from the published package source — never executed. Parsed 27 of 27 source files.

This server can read and write files and read your environment variables.

How it was published

No provenance attestation — there is nothing linking this published artifact to a specific source commit.
1 npm maintainer — a single point of compromise · last published by jessica-mulein.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit 6 months ago — No commits in over six months.
3 GitHub stars — Very little community usage so far.
Package repo does not match registry entry — The npm package points at Digital-Defiance/mcp-filesystem, while the registry lists Digital-Defiance/ai-capabilities-suite. Worth confirming you are installing what you think you are.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

B · 61

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%75%
Last commit 202 days ago.
Adoption20%18%
3 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%0%
The package's declared repository does not match the registry entry.
Packaging15%100%
Publishes a pinned version (0.1.9).

Documentation

Full README

🚀 AI Capability Extension Suite

What if AI agents could actually _see_, _debug_, and _control_ your development environment?

We've built the most comprehensive suite of MCP servers that give AI agents superpowers they've never had before. This isn't just another tool collection—it's a paradigm shift that transforms AI assistants from code generators into intelligent development partners with runtime visibility, system control, and physical world access.

📝 Note: All packages have been split into individual Git submodules with their own repositories for better maintainability and independent versioning. Each package now has its own dedicated repository under the Digital-Defiance organization.

📦 Quick Index

🐛 MCP ACS Debugger

25+ debugging tools for AI agents | VS Code Extension | NPM | Docker

✅ VS Code Extension with GitHub Copilot integration
✅ 94.53% test coverage, 1,059 tests
✅ Performance profiling, hang detection, advanced breakpoints
🎯 Kiro Superpower in development - Enhanced AI debugging workflows

📸 MCP ACS Screenshot

Visual UI capture and analysis | VS Code Extension | NPM | Docker

✅ Full screen, window, and region capture
✅ PII masking with OCR integration
✅ 267 tests, cross-platform support
🎯 Kiro Superpower in development - AI-powered visual analysis

⚙️ MCP ACS Process

Enterprise-grade process management | VS Code Extension | NPM | Docker

Excerpt — the full document is on GitHub.

Alternatives to mcp-filesystem

Maintain mcp-filesystem? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![mcp-filesystem on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/io-github-digital-defiance-mcp-filesystem)](https://mcp-skills-hub.vercel.app/mcps/io-github-digital-defiance-mcp-filesystem)

Catalog data refreshed Oct 27, 2026. Something wrong? Report it.