连接本地 MCP 服务器

原文：连接本地 MCP Server

一句话

通过配置 Claude Desktop 连接本地 MCP 服务器，扩展 AI 应用对本地资源和工具的安全访问能力。

什么时候翻这页

当你需要让 Claude 访问本地文件系统、执行文件操作或集成其他本地工具时。

核心概念

MCP 服务器：在本地计算机上运行并通过标准化协议为 Claude Desktop 提供特定功能的程序
工具 (tools)：服务器暴露给 Claude 的功能，如读取文件、创建目录、搜索文件等
资源 (resources)：服务器可以访问的数据或服务
Host：运行 MCP 服务器的应用程序（如 Claude Desktop）
Client：请求和使用 MCP 服务器功能的应用程序
prompt：向服务器发送的请求或指令

每个服务器操作都需要你的明确批准，确保你完全控制 Claude 可以访问和修改的内容。

怎么做

前置条件

Claude Desktop：下载并安装适用于你的操作系统的最新版本
Node.js：许多 MCP 服务器（如文件系统服务器）需要 Node.js 运行环境

安装文件系统服务器

打开 Claude Desktop 设置
- 在系统菜单栏中点击 Claude 菜单（不是 Claude 窗口内的设置）
- 选择 "Settings..."
访问开发者设置
- 在设置窗口中，导航到左侧边栏的 "Developer" 选项卡
- 点击 "Edit Config" 按钮打开配置文件

配置文件系统服务器

替换配置文件内容为以下 JSON 结构：

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

将 username 替换为你的实际用户名
args 数组中的路径指定服务器可以访问的目录

重启 Claude Desktop
- 完全退出并重新启动 Claude Desktop
- 成功重启后，会在对话输入框右下角看到 MCP 服务器指示器
- 点击指示器可查看文件系统服务器提供的可用工具

命令 / 配置速查

配置文件位置

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

文件系统服务器配置

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/directory1",
        "/path/to/directory2"
      ]
    }
  }
}

日志位置

macOS: ~/Library/Logs/Claude
Windows: %APPDATA%\Claude\logs
主要日志文件：mcp.log 和 mcp-server-SERVERNAME.log

查看日志命令

macOS/Linux: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Windows: type "%APPDATA%\Claude\logs\mcp*.log"

与 Claude Code / Hello-Agents 的联系

在 Hello-Agents 第 10 章中，我们学习了如何使用 MCP 服务器扩展 Agent 的能力。本手册提供了在 Claude Desktop 中配置 MCP 服务器的具体步骤，与 Hello-Agents 中的概念一致，但更侧重于客户端配置而非服务器开发。Claude Code 手册中的 MCP 章节介绍了 MCP 的基本概念，而本手册则提供了实际连接本地服务器的详细指导。

初学者易错点

配置文件语法错误：确保 JSON 格式正确，检查逗号和大括号匹配
路径问题：使用绝对路径而非相对路径，确保路径有效
服务器未启动：重启 Claude Desktop 以加载新配置
权限问题：只授予 Claude 访问你信任的目录
Node.js 未安装：许多 MCP 服务器需要 Node.js 环境
Windows 环境变量：在 Windows 上可能需要设置 APPDATA 环境变量

语义检索