摘要:本文档是一份详细的 MCP (Model Context Protocol) 入门教程,旨在帮助你快速上手,体验 AI 的强大动手能力。即使你是技术小白,跟着本教程也能轻松配置并使用你的第一个 MCP 服务。
简介
本文档是一份详细的 MCP (Model Context Protocol) 入门教程,旨在帮助你快速上手,体验 AI 的强大动手能力。即使你是技术小白,跟着本教程也能轻松配置并使用你的第一个 MCP 服务。
1. 准备工作
在开始之前,你需要完成以下准备工作:
1.1 下载并安装 Cursor
下载完成后,按照提示进行安装。
1.2 下载并安装 Node.js
访问 Node.js 官网下载安装包: https://nodejs.org/
下载适合你操作系统的版本,然后按照默认设置完成安装。
验证安装 (可选):
打开你电脑的终端(Windows 上是 "命令提示符 (cmd)" 或 "PowerShell",macOS 上是 "终端 (Terminal)")。
输入 node -v 并按回车键。
如果终端显示了 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
访问 高德开放平台 控制台并登录:https://console.amap.com/
在左侧导航栏选择 "应用管理" -> "我的应用"。
点击 "创建新应用",填写应用名称和类型。
创建应用成功后,进入该应用的详情页。
选择 "Web服务" 类型的 Key,填写 Key 的名称,并根据需要设置 IP 白名单(如果留空则不限制 IP)。
创建成功后,你将获得一个 Key。请妥善保管这个 Key。
注意: 24小时内申请的 Key 不允许删除。
5.3 使用高德地图服务
在 Cursor 的聊天界面,确保顶部的模式切换到 Agent 模式。
重要: 将代码中的 "您在高德官网上申请的key" 替换为你实际申请到的高德地图 Key。
{ "mcpServers": { "amap-amap-sse": { "url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key" } } }保存 mcp.json 文件。
回到 Cursor 的 MCP 设置界面,点击刷新按钮,检查新添加的高德地图服务是否显示绿灯 ✅。
现在,你可以在 Agent 模式下向 AI 发出与路线规划相关的指令了:
我在北京大兴机场,女朋友在首都国际机场,请用高德地图推荐一个位于我们中间的商业街区(要求交通便利,适合见面),并列出该商业街排名前三的火锅店,同时提供从两个机场分别前往的公共交通或驾车路线。希望这篇教程对你有帮助!记得点赞、收藏、关注!
来源:世道科技圈