modelcontextprotocol 服务器通过提供对本地资源和工具的安全可控访问，扩展了人工智能应用的能力。众多客户端支持 modelcontextprotocol，实现了跨不同平台和应用的多样化集成可能性。 本指南演示了如何以Claude Desktop为例连接本地MCP服务器，这是众多支持MCP的客户端之一。虽然我们重点介绍Claude Desktop的实现方式，但这些概念广泛适用于其他兼容MCP的客户端。通过本教程，Claude将能够在您的计算机上执行以下操作：与文件交互、创建新文档、整理文件夹以及搜索文件系统——所有操作都将获得您的明确许可。
Claude Desktop with filesystem integration showing file management capabilities

​
前提条件

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

​
Claude桌面应用

下载并安装适用于您操作系统的Claude Desktop。Claude Desktop目前支持macOS和Windows。即将提供Linux支持。 如果您已经安装了Claude Desktop，请通过点击Claude菜单并选择"检查更新..."来确认您正在运行最新版本。

​
Node.js

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

​
理解 Model Context Protocol 服务器

MCP servers 是运行在您计算机上的程序，通过标准化协议向 Claude Desktop 提供特定能力。每个服务器会暴露工具，在获得您批准后 Claude 可使用这些工具执行操作。我们将安装的文件系统服务器提供以下功能：
  • 读取文件内容与目录结构
  • 创建新文件和目录
  • 移动和重命名文件
  • 通过文件名或内容搜索文件
除非收到您的明确批准，否则所有操作都不会执行，确保您完全掌控Claude可以访问和修改的内容。

​
安装文件系统服务器

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

打开Claude桌面设置

首先访问Claude桌面设置。点击系统菜单栏中的Claude菜单（不是Claude窗口内部的设置），然后选择"Settings…"在macOS上，这将显示在顶部菜单栏中：
Claude Desktop menu showing Settings option
这会打开Claude桌面配置窗口，该窗口与您的Claude账户设置是分开的。
2

访问开发者设置

在设置窗口中，导航至左侧边栏的“Developer（开发者）”标签页。此部分包含配置MCP服务器和其他开发者功能的选项。点击“编辑配置”按钮打开配置文件：
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桌面应用启动文件系统服务器并授予对特定目录的访问权限：
{
  "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": Filesystem Server的包名称
  • 剩余参数：服务器允许访问的目录
安全考量仅授予访问您允许Claude读取和修改的目录权限。服务器以您的用户账户权限运行，因此它可以执行您手动可以执行的任何文件操作。
4

重启Claude Desktop

保存配置文件后，请完全退出并重启Claude Desktop应用。应用需要重新启动才能加载新配置并启动MCP服务器。重启成功后，您会看到对话输入框的右下角出现一个MCP服务器指示器：
Claude Desktop interface showing MCP server indicator
点击此指示器查看 Filesystem Server 提供的可用工具：
Available filesystem tools in Claude Desktop
如果服务器指示器没有出现，请参考Troubleshooting章节获取调试步骤。

​
使用文件系统服务器

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

​
文件管理示例

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

​
审批工作原理

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

​
故障排除

如果在设置或使用文件系统服务器时遇到问题，以下解决方案可解决常见问题：

​
下一步

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

探索其他服务器

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

构建你自己的服务器

创建定制化的MCP服务器，满足您的特定工作流程和集成需求

连接至远程服务器

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

理解协议

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