在本教程中,您将扩展 Claude for Desktop 的功能,使其能够读取计算机的文件系统、写入新文件、移动文件,甚至搜索文件。

不用担心 —— 在执行这些操作之前,它会征求您的许可!

1. 下载 Claude for Desktop

首先下载 Claude for Desktop,选择 macOS 或 Windows。(Linux 目前不支持 Claude for Desktop。)

按照安装说明进行操作。

如果您已经安装了 Claude for Desktop,请确保它是最新版本,方法是点击计算机上的 Claude 菜单并选择“检查更新…”。

2. 添加文件系统 MCP 服务器

为了添加此文件系统功能,我们将安装一个预构建的 文件系统 MCP 服务器 到 Claude for Desktop。这是 Anthropic 和社区创建的众多服务器之一。

首先,打开计算机上的 Claude 菜单并选择“设置…”。请注意,这些不是应用程序窗口中的 Claude 账户设置。

在 Mac 上应该是这样的:

点击设置窗格左侧栏中的“开发者”,然后点击“编辑配置”:

这将在以下位置创建一个配置文件:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json

如果文件不存在,它将创建该文件并在文件系统中显示它。

在任何文本编辑器中打开配置文件。将文件内容替换为以下内容:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

确保将 username 替换为您的计算机用户名。路径应指向您希望 Claude 能够访问和修改的有效目录。它设置为适用于桌面和下载文件夹,但您也可以添加更多路径。

您还需要在计算机上安装 Node.js 才能正常运行。要验证您是否安装了 Node,请在计算机上打开命令行。

  • 在 macOS 上,从应用程序文件夹中打开终端
  • 在 Windows 上,按 Windows + R,输入“cmd”,然后按 Enter

进入命令行后,通过输入以下命令验证您是否安装了 Node:

node --version

如果出现“command not found”或“node is not recognized”错误,请从 nodejs.org 下载 Node。

配置文件如何工作?

此配置文件告诉 Claude for Desktop 每次启动应用程序时要启动哪些 MCP 服务器。在本例中,我们添加了一个名为“filesystem”的服务器,它将使用 Node 的 npx 命令安装并运行 @modelcontextprotocol/server-filesystem。此服务器在此处描述,它将允许您在 Claude for Desktop 中访问您的文件系统。

命令权限

Claude for Desktop 将以您用户账户的权限运行配置文件中的命令,并访问您的本地文件。仅在您理解并信任来源的情况下添加命令。

3. 重新启动 Claude

更新配置文件后,您需要重新启动 Claude for Desktop。

重新启动后,您应该会在输入框的右下角看到一个锤子 图标:

点击锤子图标后,您应该会看到文件系统 MCP 服务器附带的工具:

如果您的服务器未被 Claude for Desktop 识别,请继续阅读故障排除部分以获取调试提示。

4. 试试看!

您现在可以与 Claude 对话并询问它有关文件系统的问题。它应该知道何时调用相关工具。

您可以尝试询问 Claude 的一些问题:

  • 你能写一首诗并保存到我的桌面吗?
  • 我的下载文件夹中有哪些与工作相关的文件?
  • 你能将桌面上的所有图片移动到一个名为“Images”的新文件夹中吗?

根据需要,Claude 将调用相关工具并在执行操作之前征求您的许可:

故障排除

后续步骤