简介

本文档是一份详细的 MCP (Model Context Protocol) 入门教程，旨在帮助你快速上手，体验 AI 的强大动手能力。即使你是技术小白，跟着本教程也能轻松配置并使用你的第一个 MCP 服务。

1. 准备工作

在开始之前，你需要完成以下准备工作：

1.1 下载并安装 Cursor

• 访问 Cursor 官网下载客户端：https://www.cursor.com/

• 下载完成后，按照提示进行安装。

1.2 下载并安装 Node.js

• 访问 Node.js 官网下载安装包：https://nodejs.org/

• 下载适合你操作系统的版本，然后按照默认设置完成安装。

• 验证安装 (可选):

1. 打开你电脑的终端（Windows 上是 "命令提示符 (cmd)" 或 "PowerShell"，macOS 上是 "终端 (Terminal)"）。

2. 输入 node -v 并按回车键。

3. 如果终端显示了 Node.js 的版本号（例如 v20.11.0），则说明安装成功。

2. 配置 MCP 服务

现在，我们来配置 Cursor 以使用 MCP 服务。

2.1 打开 Cursor 设置

• 启动 Cursor 软件。

• 找到并打开 "首选项" (Preferences) -> "Cursor Settings"。

2.2 添加 MCP 服务器配置

• 在设置界面中，找到 MCP 选项卡。

• 点击 "Add a new global MCP server"。

• 如果是首次配置，Cursor 会提示你创建一个 mcp.json 文件。点击 **创建 (Create)**。这个文件将作为你的 MCP "工具清单"。

2.3 编辑 mcp.json 文件

• 将以下 JSON 配置代码完整复制并粘贴到刚刚创建的 mcp.json 文件中。

  注意: 这份配置包含了多个预设的 MCP 工具，例如：深度思考、网页内容获取、本地文件操作、中文平台热搜、网页自动化、Hacker News 新闻获取、DuckDuckGo 搜索等。

{
  "mcpServers": {
    "@smithery-ai-server-sequential-thinking": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@smithery/cli@latest",
        "run",
        "@smithery-ai/server-sequential-thinking",
        "--config",
        "{}"
      ]
    },
    "files": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "D:/aiboshihaihai"
      ]
    },
      "@wopal-mcp-server-hotnews": {
        "command": "cmd",
        "args": [
          "/c",
          "npx",
        "@wopal/mcp-server-hotnews"
        ]
      },    
      "playwright": {
        "command": "cmd",
        "args": [
          "/c",
          "npx",
          "-y",
          "@executeautomation/playwright-mcp-server"
        ]
    }
  }
}

• 特别注意: 在名为 "files" 的工具配置中，你需要将 "C:/Users/Administrator/Desktop" 修改为你实际希望允许 AI 访问和操作的本地文件夹路径。例如，如果你想让 AI 操作 D 盘下的 AI_Work 文件夹，就修改为 "D:/AI_Work"。请谨慎设置此路径，确保只授予必要的权限。

• 保存 mcp.json 文件。

2.4 验证 MCP 服务状态

• 回到 Cursor 的 MCP 设置界面。

• 你应该能看到刚才配置的各个 MCP 服务列表。

• 如果服务名称前面显示绿色对勾 ✅，表示该服务已成功加载并准备就绪。

• 如果没有显示绿灯或加载失败，请尝试点击旁边的 刷新 (Refresh) 按钮。如果问题仍然存在，请检查 mcp.json 文件内容是否正确复制粘贴，以及 Node.js 是否正确安装。

3. 使用 MCP 工具

配置完成后，你就可以在 Cursor 中使用这些强大的 MCP 工具了。

3.1 切换到 Agent 模式

在 Cursor 的聊天界面，确保顶部的模式切换到 Agent 模式。只有在 Agent 模式下，AI 才能调用 MCP 工具。

3.2 查询可用工具

向 Agent 提问，了解当前可用的工具及其功能：

我现在有哪些可用的 MCP 工具？它们分别能做什么？

• AI 会列出它所拥有的"工具"以及每个工具的"说明书"（即功能描述）。

3.3 下达指令，调用工具

现在，你可以向 Agent 下达需要调用特定工具才能完成的任务了。以下是一些示例：

• 示例 1：网页信息提取与分析 (需要 Playwright 或 Fetch 工具)

  帮我去打开这个B站主页 https://space.bilibili.com/3546706616518839?spm_id_from=333.1387.0.0，把其视频播放量和标题都记下来，分析高播放量内容主题和标题的风格特点，并将结果保存到'D:/aiboshihaihai'的 AI博士嗨嗨分析.html 文件中。

• 示例 2：结合热搜和文件操作

  帮我根据今天的知乎热榜写一个关于知乎热榜日报，并将内容保存到'D:/aiboshihaihai'的 知乎快讯日报.txt 文件中。

• 示例 3：文件管理

  将 D 盘 D:/aiboshihaihai 文件夹里的所有文件名按顺序改成 AI博士嗨嗨1.pdf, AI博士嗨嗨2.docx ... 这样的格式。(请注意：执行此类操作前，请务必确认 "files" 工具配置的路径正确，并了解其潜在风险)

• 示例 4：结合搜索和网页自动化 (需要搜索和 Playwright 工具)

  搜索最新的AI大模型领域新闻，访问排名前三的新闻链接，总结每篇文章的核心观点，并将结果整理成中文报告。

3.4 优化体验 (可选)

自动运行模式:

• 为了避免每次 AI 调用工具时都弹出确认框，可以进入 Cursor Settings -> "Features" -> "Agent"。

• 打开 "auto-run mode" 开关。

安全设置:

• 如果你担心 AI 误操作执行危险命令（尤其是在开启自动运行模式后），可以在 "Agent" 设置下方的 "Disallowed commands" 区域添加需要禁止的命令，例如 rm -f (强制删除文件)。

4. 查找更多 MCP 工具

想要探索更多强大的 MCP 工具？可以访问 MCP 工具聚合网站：

• Smithery.ai: https://smithery.ai/

在这里你可以找到社区贡献的各种 MCP 服务器，并将它们添加到你的 mcp.json 配置中。

5. 补充案例：添加高德地图 MCP 服务

以下是如何添加一个使用高德地图 API 进行路线规划的 MCP 服务示例。

5.1 获取高德地图 API Key

1. 访问 高德开放平台 控制台并登录：https://console.amap.com/

2. 在左侧导航栏选择 "应用管理" -> "我的应用"。

3. 点击 "创建新应用"，填写应用名称和类型。

4. 创建应用成功后，进入该应用的详情页。

5. 点击 "添加 Key" 按钮。

6. 选择 "Web服务" 类型的 Key，填写 Key 的名称，并根据需要设置 IP 白名单（如果留空则不限制 IP）。

7. 创建成功后，你将获得一个 Key。请妥善保管这个 Key。

   注意： 24小时内申请的 Key 不允许删除。

5.3 使用高德地图服务

1. 在 Cursor 的聊天界面，确保顶部的模式切换到 Agent 模式。

2. 重要： 将代码中的 "您在高德官网上申请的key" 替换为你实际申请到的高德地图 Key。

{
  "mcpServers": {
    "amap-amap-sse": {
      "url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key"
    }
  }
}

1. 保存 mcp.json 文件。

2. 回到 Cursor 的 MCP 设置界面，点击刷新按钮，检查新添加的高德地图服务是否显示绿灯 ✅。

3. 现在，你可以在 Agent 模式下向 AI 发出与路线规划相关的指令了：

我在北京大兴机场，女朋友在首都国际机场，请用高德地图推荐一个位于我们中间的商业街区（要求交通便利，适合见面），并列出该商业街排名前三的火锅店，同时提供从两个机场分别前往的公共交通或驾车路线。

希望这篇教程对你有帮助！记得点赞、收藏、关注！