连接本地 MCP 服务器

本地 MCP 服务器通过提供安全的本地资源访问来扩展 AI 能力。本指南以文件系统服务器为例，演示如何连接 Claude Desktop 到本地服务器。

前置要求

必需软件

Claude Desktop：从 claude.ai/download 下载
Node.js：大多数 MCP 服务器必需。使用 node --version 验证

理解 MCP 服务器

MCP 服务器是通过标准化协议向 AI 客户端暴露工具的程序。每个服务器提供特定功能：

服务器类型	功能
文件系统	读写文件、管理目录、搜索文件
数据库	查询数据库、管理数据
API	连接外部服务

所有工具执行都需要用户明确批准，确保对 AI 操作的完全控制。

配置文件位置

平台	配置文件路径
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

连接文件系统服务器

第一步：打开配置

在 Claude Desktop 中，导航至 设置 → 开发者 → 编辑配置。

第二步：添加服务器配置

将配置文件内容替换为：

macOS:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/你的用户名/Desktop",
        "/Users/你的用户名/Documents"
      ]
    }
  }
}

Windows:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\你的用户名\\Desktop",
        "C:\\Users\\你的用户名\\Documents"
      ]
    }
  }
}

将 你的用户名 替换为实际用户名。仅授予你信任 Claude 可以读取和修改的目录访问权限。

第三步：重启 Claude Desktop

完全退出并重启 Claude Desktop。成功连接后，输入区域会显示 MCP 指示器。

使用示例

连接文件系统服务器后，尝试以下请求：

“创建我的文档文件夹摘要并保存到桌面”
“查找桌面上的所有图片并将它们组织到文件夹中”
“读取我项目目录中的 README.md 文件”

每个操作在执行前都需要你的批准。

故障排除

服务器未显示

验证 JSON 语法：确保配置文件是有效的 JSON
使用绝对路径：相对路径无法工作
检查日志：~/Library/Logs/Claude/mcp.log（macOS）或 %APPDATA%\Claude\logs（Windows）
手动测试：在终端运行 npx -y @modelcontextprotocol/server-filesystem <路径>

获取调试日志

# macOS/Linux
tail -f ~/Library/Logs/Claude/mcp*.log

# Windows PowerShell
Get-Content "%APPDATA%\Claude\logs\mcp*.log" -Wait

工具调用失败

如果工具静默失败：

检查服务器日志中的错误
验证服务器可以独立运行
完全重启 Claude Desktop

高级配置

多服务器

可以同时连接多个服务器：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/path/to/repo"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-api-key"
      }
    }
  }
}

Python 服务器

对于基于 Python 的 MCP 服务器：

{
  "mcpServers": {
    "python-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/server",
        "run",
        "server.py"
      ]
    }
  }
}

环境变量

向服务器传递环境变量：

{
  "mcpServers": {
    "api-server": {
      "command": "npx",
      "args": ["-y", "@your-org/server"],
      "env": {
        "API_KEY": "your-key",
        "API_ENDPOINT": "https://api.example.com"
      }
    }
  }
}

安全最佳实践

最小权限原则：仅授予必要的目录访问权限
定期审查权限：定期审计服务器配置
使用绝对路径：防止意外的目录访问
监控日志：关注服务器活动

可用服务器

在 github.com/modelcontextprotocol/servers 探索官方和社区服务器。

热门选项包括：

Filesystem：本地文件和目录操作
Git：仓库操作和历史记录
GitHub：GitHub 集成和 PR 管理
Postgres：数据库查询和管理
Brave Search：网络搜索功能
Puppeteer：Web 自动化和抓取

后续步骤

构建 MCP 客户端连接远程 MCP 服务器