Skip to main content
Model Context Protocol (MCP) 服务器通过提供对本地资源和工具的安全、受控访问来扩展 AI 应用程序的功能。许多客户端都支持 MCP，从而能够在不同平台和应用程序之间实现多样化的集成可能性。 本指南以 Claude Desktop 为例，演示如何连接到本地 MCP 服务器，它是 许多支持 MCP 的客户端 之一。虽然我们专注于 Claude Desktop 的实现，但这些概念广泛适用于其他兼容 MCP 的客户端。在本教程结束时，Claude 将能够与计算机上的文件交互、创建新文档、组织文件夹以及搜索您的文件系统——所有操作均需您明确许可。
显示文件管理功能的带有文件系统集成的 Claude Desktop

​
前提条件

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

​
Claude Desktop

下载并安装适用于您操作系统的 Claude Desktop。Claude Desktop 适用于 macOS 和 Windows。 如果您已经安装了 Claude Desktop，请通过点击 Claude 菜单并选择“检查更新…”来验证您是否运行的是最新版本。

​
Node.js

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

​
了解 MCP 服务器

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

​
安装文件系统服务器

该过程涉及配置 Claude Desktop，以便在每次启动应用程序时自动启动文件系统服务器。此配置是通过一个 JSON 文件完成的，该文件告诉 Claude Desktop 运行哪些服务器以及如何连接到它们。
1

打开 Claude Desktop 设置

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

访问开发者设置

在“设置”窗口中，导航到左侧边栏中的”Developer”（开发者）选项卡。此部分包含用于配置 MCP 服务器和其他开发者功能的选项。点击“编辑配置”按钮以打开配置文件：
显示编辑配置按钮的开发者设置
如果配置文件不存在，此操作将创建一个新文件，或者打开您现有的配置。该文件位于：
  • 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"
      ]
    }
  }
}
将 username 替换为您实际的计算机用户名。args 数组中列出的路径指定了文件系统服务器可以访问的目录。您可以根据需要修改这些路径或添加其他目录。
了解配置
  • "filesystem": 服务器的友好名称，显示在 Claude Desktop 中
  • "command": "npx": 使用 Node.js 的 npx 工具运行服务器
  • "-y": 自动确认服务器包的安装
  • "@modelcontextprotocol/server-filesystem": 文件系统服务器的包名
  • 其余参数：服务器允许访问的目录
安全注意事项仅授予您放心让 Claude 读取和修改的目录访问权限。服务器以您的用户账户权限运行，因此它可以执行您手动可以执行的任何文件操作。
4

重启 Claude Desktop

保存配置文件后，完全退出 Claude Desktop 并重新启动它。应用程序需要重新启动才能加载新配置并启动 MCP 服务器。成功重启后，您将在对话输入框的右下角看到一个 MCP 服务器指示器 ：
显示 MCP 服务器指示器的 Claude Desktop 界面
点击此指示器以查看文件系统服务器提供的可用工具：
Claude Desktop 中可用的文件系统工具
如果服务器指示器未出现，请参阅 故障排除 部分以获取调试步骤。

​
使用文件系统服务器

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

​
文件管理示例

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

​
批准如何工作

在执行任何文件系统操作之前，Claude 将请求您的批准。这确保您对所有操作保持控制：
Claude 请求批准执行文件操作
在批准之前仔细审查每个请求。如果您对提议的操作感到不舒服，可以随时拒绝请求。

​
故障排除

如果在设置或使用文件系统服务器时遇到问题，这些解决方案可解决常见问题：
  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
与 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
如果 Claude 尝试使用工具但失败：
  1. 检查 Claude 的日志是否有错误
  2. 验证您的服务器构建和运行无误
  3. 尝试重启 Claude Desktop
请参阅我们的 调试指南 以获取更好的调试工具和更详细的指导。
如果配置的服务器加载失败，并且您在日志中看到路径内引用 ${APPDATA} 的错误，您可能需要将 %APPDATA% 的展开值添加到 claude_desktop_config.json 中的 env 键：
{
  "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 的工作原理及其架构