跳到主要内容
模型上下文协议 (MCP) 服务器通过提供对本地资源和工具的安全、受控访问，扩展了 AI 应用的能力。许多客户端支持 MCP，从而在不同平台和应用程序之间实现了多种集成可能。 本指南以 Claude Desktop 为例，演示如何连接到本地 MCP 服务器。虽然我们侧重于 Claude Desktop 的实现，但这些概念同样适用于其他支持 MCP 的客户端。通过本教程，Claude 将能够与您计算机上的文件进行交互、创建新文档、整理文件夹以及搜索您的文件系统——所有操作均需您的明确许可。
Claude Desktop with filesystem integration showing file management capabilities

​
先决条件

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

​
Claude Desktop

下载并安装适用于您操作系统的 Claude Desktop。Claude Desktop 支持 macOS 和 Windows。 如果您已经安装了 Claude Desktop，请点击 Claude 菜单并选择“检查更新 (Check for Updates…)”以确保运行的是最新版本。

​
Node.js

文件系统服务器及许多其他 MCP 服务器需要 Node.js 才能运行。请打开终端或命令提示符并运行以下命令，以验证您的 Node.js 安装情况： 
node --version
如果未安装 Node.js，请从 nodejs.org 下载。为了稳定性，我们建议使用 LTS（长期支持）版本。

​
了解 MCP 服务器

MCP 服务器是在您的计算机上运行的程序，通过标准化协议为 Claude Desktop 提供特定功能。每个服务器都会公开一些工具，Claude 可以在获得您批准的情况下使用这些工具来执行操作。我们即将安装的文件系统服务器提供以下功能：
  • 读取文件内容和目录结构
  • 创建新文件和目录
  • 移动和重命名文件
  • 按名称或内容搜索文件
所有操作在执行前都需要您的明确批准，确保您始终完全掌控 Claude 可以访问和修改的内容。

​
安装文件系统服务器 (Filesystem Server)

整个过程包括配置 Claude Desktop，使其在您启动应用程序时自动运行文件系统服务器。此配置通过一个 JSON 文件完成，该文件告知 Claude Desktop 要运行哪些服务器以及如何连接到它们。
1

打开 Claude Desktop 设置

首先访问 Claude Desktop 设置。点击系统菜单栏中的 Claude 菜单（而非 Claude 窗口内的设置），然后选择“设置 (Settings…)”。在 macOS 上，它出现在顶部菜单栏中：
Claude Desktop menu showing Settings option
这将打开 Claude Desktop 配置窗口，它与您的 Claude 账户设置是分开的。
2

访问开发者设置

在设置窗口中，导航到左侧边栏的“开发者 (Developer)”选项卡。此部分包含用于配置 MCP 服务器和其他开发者功能的选项。点击“编辑配置 (Edit Config)”按钮以打开配置文件：
Developer settings showing Edit Config button
如果配置文件不存在，此操作将创建一个新文件；如果已存在，则会直接打开。该文件位于：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
3

配置文件系统服务器

将配置文件的内容替换为以下 JSON 结构。此配置告诉 Claude Desktop 在启动时运行文件系统服务器，并授予其对特定目录的访问权限：
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\username\\Desktop",
        "C:\\Users\\username\\Downloads"
      ]
    }
  }
}
将 username 替换为您实际的计算机用户名。args 数组中列出的路径指定了文件系统服务器可以访问的目录。您可以根据需要修改这些路径或添加其他目录。
理解配置
  • "filesystem"：服务器的友好名称，会显示在 Claude Desktop 中
  • "command": "npx"：使用 Node.js 的 npx 工具来运行服务器
  • "-y"：自动确认安装服务器包
  • "@modelcontextprotocol/server-filesystem"：文件系统服务器的包名称
  • 其余参数：服务器被允许访问的目录
安全注意事项仅授予您允许 Claude 读取和修改的目录的访问权限。服务器以您的用户账户权限运行，因此它可以执行您手动可以执行的任何文件操作。
4

重启 Claude Desktop

保存配置文件后，请完全退出 Claude Desktop 并重新启动它。应用程序需要重启以加载新配置并启动 MCP 服务器。重启成功后，点击对话输入框左下角的“添加文件、连接器等 (Add files, connectors and more)”图标 。
Claude Desktop interface showing MCP server indicator
点击该图标，然后滚动鼠标至“连接器 (Connectors)”并点击“管理连接器 (Manage connectors)”。从连接器列表中选择“filesystem”以查看文件系统服务器可用的工具。
Available filesystem tools in Claude Desktop
如果文件系统服务器未连接，请参阅“故障排除”部分获取调试步骤。

​
使用文件系统服务器

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

​
文件管理示例

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

​
批准机制的工作原理

在执行任何文件系统操作之前，Claude 都会请求您的批准。这确保了您对所有操作拥有绝对的掌控权。
Claude requesting approval to perform a file operation
在批准之前，请仔细检查每个请求。如果您对提议的操作感到不安，可以随时拒绝。

​
故障排除

如果您在设置或使用文件系统服务器时遇到问题，以下解决方案可以解决常见问题：
  1. 彻底重启 Claude Desktop
  2. 检查 claude_desktop_config.json 文件的语法
  3. 确保 claude_desktop_config.json 中包含的文件路径是有效的，并且必须是绝对路径，而非相对路径
  4. 查看 日志 以了解服务器无法连接的原因
  5. 在命令行中，尝试手动运行服务器（按照您在 claude_desktop_config.json 中所做的那样替换 username），查看是否出现任何错误
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads

npx -y @modelcontextprotocol/server-filesystem C:\Users\username\Desktop C:\Users\username\Downloads
与 MCP 相关的 Claude.app 日志写入在以下位置的日志文件中：
  • macOS: ~/Library/Logs/Claude
  • Windows: %APPDATA%\Claude\logs
  • mcp.log 将包含关于 MCP 连接和连接失败的常规日志。
  • 名为 mcp-server-SERVERNAME.log 的文件将包含来自相应服务器的错误 (stderr) 日志。
您可以运行以下命令列出最近的日志并跟踪新日志（在 Windows 上，它仅显示最近的日志）：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

type "%APPDATA%\Claude\logs\mcp*.log"
如果 Claude 尝试使用工具但失败：
  1. 检查 Claude 的日志以获取错误信息
  2. 验证您的服务器构建和运行是否没有错误
  3. 尝试重启 Claude Desktop
请参阅我们的 调试指南 以获取更好的调试工具和更详细的指导。
如果配置的服务器无法加载，且您在日志中看到引用路径中 ${APPDATA} 的错误，您可能需要在 claude_desktop_config.json 的 env 键中添加 %APPDATA% 的展开值。
{
  "brave-search": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
    "env": {
      "APPDATA": "C:\\Users\\user\\AppData\\Roaming\\",
      "BRAVE_API_KEY": "..."
    }
  }
}
完成此更改后，请再次启动 Claude Desktop。
npm 应全局安装如果您未全局安装 npm，npx 命令可能会持续失败。如果 npm 已全局安装，您会在系统中找到 %APPDATA%\npm 目录。如果没有，您可以通过运行以下命令全局安装 npm：
npm install -g npm

​
后续步骤

既然您已成功将 Claude Desktop 连接到本地 MCP 服务器，请探索以下选项以扩展您的设置：

探索其他服务器

浏览我们收集的官方和社区创建的 MCP 服务器，以获取更多功能

构建您自己的服务器

创建量身定制的 MCP 服务器，以适应您的特定工作流程和集成需求

连接到远程服务器

了解如何将 Claude 连接到远程 MCP 服务器，以使用基于云的工具和服务

了解协议

深入了解 MCP 的工作原理及其架构