MCP 是什么（给非技术用户的解释）

Model Context Protocol（MCP）是一套让AI工具（Claude、Cursor等）能够「操作」外部工具的协议。

没有MCP：AI只能回答问题，无法访问你的文件、数据库或外部服务 有了MCP：AI可以读写文件、查询数据库、搜索网络、操作代码仓库

简单比喻：MCP就像给AI装上了「手」，让它能真正操作计算机，而不只是「嘴巴」。

安装前准备

必须安装：

Node.js 18+ （node -v验证）

Python 3.9+ （如果使用Python版MCP服务器）

npm 或 npx（Node.js自带）

可选安装（推荐）：

uv（Python包管理器，比pip更快）：pip install uv

Claude Desktop 配置方法

配置文件位置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

基础配置示例（文件系统+网络获取）：

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

修改后： 完全重启Claude Desktop（不只是关闭窗口，要退出整个应用）

Cursor 配置方法

全局配置文件：~/.cursor/mcp.json

项目级配置： 在项目根目录创建.cursor/mcp.json

json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_你的token"
      }
    }
  }
}

验证安装是否成功

Claude Desktop： 重启后，在对话中问「你能访问什么工具？」，如果列出了MCP工具名称，说明安装成功。

Cursor： 在.cursor/mcp.json配置后，在Cursor设置 → MCP中查看服务器状态（绿点=正常）。

推荐新手先装的5个MCP

filesystem - 读写文件：@modelcontextprotocol/server-filesystem

fetch - 获取网页内容：mcp-server-fetch（需要uvx）

memory - 跨对话记忆：@modelcontextprotocol/server-memory

brave-search - 网络搜索（需要Brave API key）

github - Git仓库操作（需要GitHub token）

常见错误解决

错误1：command not found: npx 解决：安装Node.js，确保node在PATH中

错误2：MCP服务器显示红点/无法连接 解决：检查配置文件JSON格式是否正确（推荐用JSON验证器）

错误3：文件系统MCP但Claude说「无法访问文件」 解决：确保配置中的路径是正确的绝对路径，且Claude有读取权限

错误4：uvx: command not found 解决：pip install uv 然后确保uv在PATH中