1.连接到本地MCP服务器 #

了解如何通过本地MCP服务器扩展Claude Desktop，实现文件系统访问及其他强大集成功能

2.概述 #

Model Context Protocol (MCP) 服务器通过提供对本地资源和工具的安全、受控访问，扩展了AI应用的能力。众多客户端支持MCP，实现了跨不同平台和应用的多样化集成可能性。

本指南以Claude Desktop为例，演示如何连接本地MCP服务器。在我们专注于Claude Desktop实现的同时，这些概念也广泛适用于其他MCP兼容客户端。通过本教程的学习，Claude将能够在获得您每次操作明确授权的前提下：与计算机上的文件交互、创建新文档、整理文件夹以及搜索您的文件系统。

3.先决条件 #

在开始本教程之前，请确保您的系统已安装以下内容：

3.1 Claude 桌面版 #

下载并安装Claude桌面版适用于您的操作系统。Claude Desktop目前支持macOS和Windows平台，Linux版本即将推出。

如果您已安装Claude Desktop，请点击Claude菜单并选择"Check for Updates…"以确认您正在运行最新版本。

3.2 Node.js #

Filesystem Server 以及许多其他 MCP 服务器需要 Node.js 才能运行。请通过打开终端或命令提示符并运行以下命令来验证您的 Node.js 安装：

node --version

如果尚未安装Node.js，请从nodejs.org下载。我们推荐使用LTS（长期支持）版本以确保稳定性。

4.理解MCP服务器 #

MCP服务器是运行在您计算机上的程序，通过标准化协议为Claude Desktop提供特定功能。每个服务器都会公开一些工具，在获得您许可后Claude可以使用这些工具执行操作。我们将要安装的Filesystem Server提供以下功能工具：

• 读取文件内容和目录结构
• 创建新文件和目录
• 移动和重命名文件
• 按文件名或内容搜索文件

所有操作在执行前都需要您的明确批准，确保您能完全掌控Claude可访问和修改的内容。

5.安装文件系统服务器 #

该过程涉及配置Claude Desktop，使其在启动应用程序时自动运行Filesystem Server。这一配置通过一个JSON文件完成，该文件指示Claude Desktop应运行哪些服务器以及如何连接到它们。

5.1 步骤1：打开Claude桌面设置 #

首先进入Claude Desktop的设置。点击系统菜单栏中的Claude菜单（注意不是Claude窗口内的设置），然后选择"Settings…"

在macOS上，这会显示在顶部菜单栏中：

这将打开Claude Desktop配置窗口，该窗口与您的Claude账户设置是分开的。

5.2 步骤2：访问开发者设置 #

在设置窗口中，左侧边栏导航至"Developer"选项卡。此部分包含配置MCP服务器及其他开发者功能的选项。

点击"Edit Config"按钮打开配置文件：

此操作会在配置文件不存在时创建一个新的，或打开您现有的配置文件。该文件位于：

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

5.3 步骤3：配置Filesystem服务器 #

将配置文件内容替换为以下JSON结构。此配置指示Claude Desktop启动Filesystem Server并授予对特定目录的访问权限：

5.3.1 macOS 配置 #

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

5.3.2 Windows 配置 #

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

替换 username 用你实际的计算机用户名。列出的路径位于 args array 指定了 Filesystem Server 可以访问的目录。您可以根据需要修改这些路径或添加其他目录。

理解配置

• "filesystem" 服务器在Claude Desktop中显示的友好名称
• "command": "npx" 使用Node.js的npx工具来运行服务器
• "-y" 自动确认服务器包的安装
• "@modelcontextprotocol/server-filesystem" Filesystem Server的包名
• 剩下的参数是服务器可以访问的目录路径

⚠️ 安全考量 仅授予Claude访问和修改您认为合适的目录权限。服务器以您的用户账户权限运行，因此它能执行您手动操作的所有文件操作。

5.4 步骤4：重启Claude Desktop #

保存配置文件后，请完全退出Claude Desktop并重新启动。应用程序需要重启以加载新配置并启动MCP服务器。

重启成功后，您将看到一个MCP服务器指示灯在对话输入框的右下角。

点击此指示器查看Filesystem Server提供的可用工具：

如果服务器指示灯未亮起，请参考故障排除调试步骤部分。

6.使用Filesystem Server #

文件系统服务器连接后，Claude现在可以与您的文件系统交互。尝试以下示例请求来探索功能：

6.1 文件管理示例 #

• "你能写首诗并保存到我的桌面吗？" - Claude 将创作一首诗并在你的桌面上创建一个新的文本文件
• "我的下载文件夹中有哪些与工作相关的文件？" - Claude将扫描您的下载内容并识别出工作相关文档
• "请将我桌面上的所有图片整理到一个名为'Images'的新文件夹中" - Claude 将创建一个文件夹并将图片文件移入其中

6.2 审批流程说明 #

在执行任何文件系统操作之前，Claude都会征求您的批准。这确保您对所有操作保持控制权。

在批准前仔细审核每个请求。如果对提议的操作感到不安，您随时可以拒绝请求。

7.故障排除 #

如果在设置或使用Filesystem Server时遇到问题，以下解决方案可应对常见故障：

7.1 服务器未在Claude中显示/锤子图标缺失 #

1. 完全重启Claude Desktop
2. 检查你的 claude_desktop_config.json 文件语法
3. 确保文件中包含的路径 claude_desktop_config.json 是有效的，并且它们是绝对而非相对的
4. 看看日志查看服务器为何无法连接
5. 在你的命令行中，尝试手动运行服务器（替换 username 正如你所做的那样 claude_desktop_config.json）检查是否出现任何错误：

7.1.1 macOS/Linux #

npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads

7.1.2 Windows #

npx -y @modelcontextprotocol/server-filesystem C:\Users\username\Desktop C:\Users\username\Downloads

7.2 从Claude Desktop获取日志 #

Claude.app 中与 MCP 相关的日志记录写入以下位置的日志文件：

• macOS: ~/Library/Logs/Claude
• Windows: %APPDATA%\Claude\logs
• mcp.log 将包含关于MCP连接及连接失败的一般日志记录
• 文件名为 mcp-server-SERVERNAME.log 将包含来自指定服务器的错误（stderr）日志记录

您可以运行以下命令来列出最近的日志并实时跟踪新日志（在Windows上，该命令仅显示最近的日志）：

7.2.1 macOS/Linux #

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

7.2.2 Windows #

type "%APPDATA%\Claude\logs\mcp*.log"

7.3 工具调用静默失败 #

如果Claude尝试使用工具但失败了：

1. 检查Claude的日志以查找错误
2. 验证您的服务器构建并运行无误
3. 尝试重启Claude Desktop

7.4 这完全没用。我该怎么办？ #

请参考我们的调试指南为了更好的调试工具和更详细的指导。

7.5 Windows 路径中的 ENOENT 错误与 $ 符号 #

如果您配置的服务器加载失败，且在其日志中看到涉及错误的提示 ${APPDATA} 在路径内，可能需要添加展开后的值 %APPDATA% 到你的 env 键入 claude_desktop_config.json:

{
  "brave-search": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
    "env": {
      "APPDATA": "C:\\Users\\user\\AppData\\Roaming\\",
      "BRAVE_API_KEY": "..."
    }
  }
}

完成此更改后，再次启动Claude Desktop。

⚠️ NPM应全局安装 这 npx 如果你尚未全局安装NPM，该命令可能会继续失败。若NPM已全局安装，你将发现 %APPDATA%\npm 存在于您的系统中。如果没有，您可以通过运行以下命令全局安装NPM：

npm install -g npm