MCP SERVER

Filesystem MCP

把指定文件夹接入 AI，读取资料、搜索文件并整理项目。

NPM · Node.js中级 · 需配置依赖

接入前准备

Node.js LTS 与 npm / npx，建议 Node.js 22 或更新的受支持 LTS。
支持本地 stdio MCP 的 Cursor 或 Claude Desktop。
一个已经存在、允许 AI 读写的独立工作文件夹。
首次运行可访问 npm；不需要单独申请该服务器的 API Key。

能力介绍

Model Context Protocol 官方参考服务器为客户端提供本地文件读取、写入、搜索和目录操作。它接入的是文件系统，不是数据库查询接口，也不会自动赋予 AI 整台电脑的权限。

适用场景

归纳一个项目文件夹中的文本资料。
按文件名搜索素材，整理已有目录。
把生成的草稿保存到指定工作文件夹。

接入步骤

安装 Node.js LTS，确认 node 与 npx 可用；建议使用 Node.js 22 或更新的受支持 LTS。
先创建单独的 AIWorkspace 文件夹，把示例路径替换为它的真实绝对路径。
Windows 选择 Cursor 或 Claude Desktop 示例；macOS / Linux 使用对应 Tab。Linux 路径可改为 /home/你的用户名/AIWorkspace。
合并配置、重启客户端，先调用 list_allowed_directories 确认实际可访问目录，再读取一个测试文本文件。

权限边界

服务器同时包含写入和移动等操作，示例不是只读配置。不要直接授权磁盘根目录、完整用户目录或含凭据的文件夹。支持 MCP Roots 的客户端可能用 Roots 替换启动参数中的目录列表，因此应检查实际目录，不能只凭配置中的路径判断访问范围。

配置说明

Windows 示例使用 cmd /c 启动 npx，避免客户端直接启动批处理命令的问题。macOS / Linux 使用 npx。已有 mcpServers 时只合并 filesystem 项；路径中的用户名是占位符，必须修改。此页核验了官方资料，未在你的电脑执行安装或文件操作。

官方资料

功能与目录控制 · Claude Desktop 本地服务器指南 · Cursor MCP 配置

接入配置

选择你的环境

JSON

Cursor Claude Desktop CLI macOS / Linux

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/Users/YOUR_USERNAME/AIWorkspace"
      ]
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/Users/YOUR_USERNAME/AIWorkspace"
      ]
    }
  }
}

claude mcp add filesystem -- cmd /c npx -y @modelcontextprotocol/server-filesystem C:/Users/YOUR_USERNAME/AIWorkspace

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/YOUR_USERNAME/AIWorkspace"
      ]
    }
  }
}

Windows 示例。必须替换 YOUR_USERNAME 并先创建目标目录；合并到 .cursor/mcp.json。连接后检查 list_allowed_directories，Cursor 的 Roots 可能改变实际目录范围。