MCP 官方文档中文版
  1. 快速上手
MCP 官方文档中文版
  • 开始使用
    • 简介
    • 示例 Servers
    • 示例 Clients
    • 快速上手
      • 服务器开发
      • 客户端开发
      • Claude 桌面版开发
  • 教程
    • 使用 LLMs 构建 MCP
    • 调试 Debugging
    • 调试器 Inspector
  • 概念
    • 核心架构
    • 资源 Resources
    • 提示词 Prompts
    • 工具 Tools
    • 采样 Sampling
    • 根 Roots
    • 传输 Transports
  • 开发
    • 新计划
    • 规划
    • 贡献
  1. 快速上手

Claude 桌面版开发

开始在 Claude 桌面版(Claude for Desktop)中使用预构建的服务器。
在本教程中,您将扩展 Claude 桌面版,使其能够读取计算机的文件系统、写入新文件、移动文件,甚至搜索文件。
img
不用担心 —— 在执行这些操作之前,它会征求您的许可!

1. 下载 Claude 桌面版#

首先下载 Claude 桌面版,选择 macOS 或 Windows。( Claude 桌面版尚不支持 Linux。)
按照安装说明进行操作。
如果您已经安装了 Claude 桌面版,请通过单击计算机上的 Claude 菜单并选择“检查更新…”来确保它是最新版本。
为什么选择 Claude 桌面版而不是 Claude.ai?

2. 添加文件系统 MCP 服务器(Filesystem MCP Server)#

为了添加此文件系统功能,我们将把预构建的 文件系统 MCP 服务器(Filesystem MCP Server) 安装到 Claude for Desktop。这是 Anthropic 和社区创建的数十个服务器之一。
首先打开计算机上的 Claude 菜单,然后选择“设置…” 请注意,这些不是在应用程序窗口本身中找到的 Claude 帐户设置。
在 Mac 上,它应该如下所示:
img
单击“设置”窗格左侧栏中的“开发者”,然后单击“编辑配置”:
img
这将创建一个配置文件,路径为:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
如果您还没有配置文件,则会创建该文件,并在您的文件系统中显示该文件。
在任何文本编辑器中打开配置文件。 将文件内容替换为以下内容:
MacOS/Linux
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}
Windows
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\username\\Desktop",
        "C:\\Users\\username\\Downloads"
      ]
    }
  }
}
请确保将 username 替换为您的计算机用户名。 这些路径应指向您希望 Claude 能够访问和修改的有效目录。 它设置为可用于桌面和下载,但您也可以添加更多路径。
您还需要在计算机上安装 Node.js 才能使其正常运行。 要验证是否已安装 Node,请打开计算机上的命令行。
在 macOS 上,从“应用程序”文件夹中打开“终端”
在 Windows 上,按 Windows + R,键入“cmd”,然后按 Enter
进入命令行后,输入以下命令验证是否已安装 Node:
如果您收到错误消息“command not found”或“node is not recognized”,请从 nodejs.org 下载 Node。
配置文件的作用是什么?
此配置文件告诉 Claude 桌面版每次启动应用程序时启动哪些 MCP 服务器。 在这种情况下,我们添加了一个名为“filesystem”的服务器,该服务器将使用 Node npx 命令来安装和运行 @modelcontextprotocol/server-filesystem。 此服务器,此处 描述,将允许您在 Claude 桌面版中访问您的文件系统。
命令权限
Claude 桌面版将使用您的用户帐户的权限运行配置文件中的命令,并访问您的本地文件。 仅当您理解并信任来源时才添加命令。

3. 重启 Claude#

更新配置文件后,您需要重新启动 Claude 桌面版。
重新启动后,您应该在输入框的右下角看到一个锤子 img 图标:
img
单击锤子图标后,您应该会看到文件系统 MCP 服务器(Filesystem MCP Server)附带的工具:
img
如果您的服务器未被 Claude 桌面版拾取,请转到故障排除部分,获取调试提示。

4. 试用一下!#

您现在可以与 Claude 对话并询问有关您的文件系统的问题。 它应该知道何时调用相关工具。
您可以尝试询问 Claude 的一些事项:
你能写一首诗并将其保存到我的桌面吗?
我的下载文件夹中有哪些与工作相关的文件?
你能把我桌面上所有的图片都移到一个名为“Images”的新文件夹里吗?
根据需要,Claude 将调用相关工具并在采取操作之前征求您的批准:
img

扫码加入 Apifox MCP 内测群

MCP生态正在快速发展,我们正在与开发者们一起探索 AI 和 API 协作的未来。

扫码加入交流群
上一页
客户端开发
下一页
使用 LLMs 构建 MCP
Built with