编者按:本系列第二篇文章聚焦 Cursor——一款基于 VS Code 构建的 AI 增强代码编辑器。文章首先概述了 Cursor 之所以适合充当 MCP 客户端的原因:图形化的 MCP 设置页面、支持工具调用、同时提供 stdio 与 SSE 两种传输方式,以及庞大的开源服务器生态。随后逐步讲解编辑器的下载与安装、界面语言切换,以及 Node.js、Git(Python 为可选)等前置环境的准备,并以 MCP 市场中的一个网页抓取服务为实操示例,演示如何通过 “Add New MCP Server”(添加新 MCP 服务器)对话框添加服务器。最适合想要在 AI 辅助编程中获得工具调用能力的开发者。要点:直接从 MCP 目录复制现成的 JSON 安装命令粘贴到 Cursor 的对话框中,而不是手动编写配置。跟练时可常备的官方页面:Cursor 文档、MCP 规范、MCP 参考服务器。

编者注(2026年10月):目前的 MCP 服务器与 SDK 通常要求 Node.js 18 或更高版本;本篇早期教程中的版本下限已在正文中更正。

本文是 MCP 客户端入门系列教程的第二篇:《MCP 客户端入门教程:Cursor 的安装与配置》。

MCP 客户端入门教程:Cursor 的安装与配置

MCP(Model Context Protocol,模型上下文协议)是 Anthropic(Claude 的母公司)于 2024年 11月发布的开放标准协议。它为开发者提供了一种强大的工具,可在数据源与 AI 驱动的工具之间建立安全的双向连接。

简单来说,如果把 AI 比作一台只能处理文本的智能设备,那么 MCP 就相当于为它安装了一个“万能插头”,让它能够直接读取你的电脑文件、查询数据库,甚至操作 GitHub 提交代码、调用各类第三方平台。

目前,MCP 已在 Claude 桌面版、Cline、Continue、Cursor、Windsurf 等众多 AI 工具中得到广泛应用。本文中,AIbase 将重点介绍 Cursor 编辑器的安装流程与 MCP 服务的配置方法。通过本教程,你将学会如何快速搭建 Cursor 并连接 MCP 服务器,充分利用 AI 辅助编程的强大功能。

一、Cursor 简介

Cursor 作为 MCP 客户端的优势

Cursor 是一款基于 VS Code 的 AI 增强代码编辑器,同时也是一款功能强大的 MCP 客户端。作为 MCP 客户端,Cursor 具有以下优势:

  • 界面直观:提供图形化的 MCP 服务器配置界面。
  • 支持工具调用:支持 MCP 协议中的 Tools 功能。
  • 配置选项灵活:同时支持命令行(stdio)与网络(sse)两种传输方式。
  • 生态丰富:拥有大量开源 MCP 服务器资源。

二、Cursor 的安装步骤

1. 下载 Cursor

首先,我们需要从 Cursor 官方网站下载软件的最新版本。访问 Cursor 官方网站:https://www.cursor.com/

2. 网站会根据你的操作系统自动提供对应版本的下载,一般如下:

Windows 用户:选择 Windows 10/11 (x64)。

Mac 用户:根据处理器选择对应版本(Universal/Arm64/x64)。

Linux 用户:选择对应的 .AppImage 版本。

2. 安装 Cursor

Windows 安装步骤:双击下载好的安装文件(通常为 .exe 格式),等待安装程序自动完成安装过程(Cursor 通常无需选择安装目录)。

安装完成后,登录账号:使用 GitHub、Google 或邮箱创建/登录 Cursor 账号。Cursor 会自动启动并显示配置界面。

3. 初始配置

键盘布局选择:根据个人喜好选择 Vim 或 Emacs 布局,如果不熟悉,可以选择默认的 “None”。主题选择:选择浅色或深色主题。

隐私设置:如果不想与 Cursor 共享你的数据,可以选择 Privacy Mode(隐私模式)。

4. 中文界面设置(可选)

如果想使用中文界面,可以按以下方式操作:

1)使用扩展程序设置中文

打开 Cursor 软件,按下键盘组合键 Ctrl+Shift+X 进入扩展程序页面。在搜索框中输入 “Chinese” 搜索中文语言包,在搜索结果中找到合适的中文语言包并点击安装。安装完成后重启 Cursor 软件,即可看到软件界面已成功切换为中文。

2)通过语言设置配置中文

打开 Cursor 软件,按下键盘组合键 Ctrl+Shift+P 打开命令面板。在命令面板的搜索框中输入 “configure display language” 并按回车。

在弹出的语言配置页面中,选择 “Chinese (Simplified)” 作为显示语言。点击 “Save”(保存)按钮并重启 Cursor 软件,即可看到软件界面已成功切换为中文。

三、MCP 配置步骤

要在 Cursor 中使用 MCP 功能,需要先完成 MCP 服务器的配置。以下是详细步骤:

1. 准备基础环境

配置 MCP 之前,请确保系统中已安装以下组件:

  • Node.js:版本 ≥ 18(验证方法:在命令行输入 node -v 查看版本号)
  • Git:最新稳定版
  • Python:部分 MCP 服务需要 Python 3.10 或更高版本(可选)

2. 进入 Cursor 的 MCP 设置

可以通过以下两种方式打开 Cursor 设置:

1)点击右上角的齿轮图标,即 “Settings”(设置)选项,在出现的左侧菜单中找到并点击 “MCP”。

2)使用快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)打开命令面板,在搜索框中搜索 “Cursor Settings”,并在左侧菜单中找到并点击 “MCP”。


3. 添加 MCP 服务器

在 MCP 设置页面,点击 “+ Add New MCP Server”(添加新 MCP 服务器)按钮,会出现一个配置窗口:

点击 “Add”(添加)后会出现编辑框,输入 MCP 服务的配置代码。

官方示例:这里的 MCP 配置文件采用 JSON 格式,结构如下:

4. 配置 Web 搜索 MCP 服务(示例)

以下是配置 Web 搜索 MCP 服务的具体步骤:

访问魔搭社区 MCP 广场:https://modelscope.cn/mcp。例如,选择 “fetch 网页内容抓取” 服务:

在右侧找到并复制 Cursor 安装命令:

将命令字段复制进编辑器并保存,即可成功添加上例中的 “fetch 网页内容抓取” MCP 服务。

5. 验证 MCP 服务器状态

添加完成后,你会在目录中看到新的 “fetch” MCP 服务,MCP 服务器应显示为可用状态。配置成功的 MCP 服务器会在列表中显示绿色指示灯或对勾。

同理,AIbase 在本例中还添加了另一个可生成图片的 MCP 服务 “fal ai”,后续可以组合使用。

四、使用 MCP 功能

在使用配置好的 MCP 功能时,需要注意以下几点:

1. 使用限制

重要说明:目前 MCP 工具并不适用于所有模型,仅在 Composer 的 Agent 中可用。在新版 Cursor 中,Composer 已被移到聊天框左下角,并更名为 “Edit”。

2. 测试 MCP 功能

打开 Cursor 的聊天功能,按以下步骤测试 MCP:

1)点击聊天框左下角的 “Edit” 按钮切换到 Agent 模式,然后在聊天框中输入相关指令,测试 MCP 工具能否被正常调用。

2)进入 Agent 模式聊天窗口,输入指令,观察 Cursor 是否调用相应的 MCP 工具并返回结果。当 MCP 工具被成功调用时,会显示 “Called MCP tool” 提示。

接下来,AIbase 具体演示一下实现效果。在聊天窗口输入链接 “https://www.chinaz.com/ainews/17410.shtml”,提示词为 “用 200 字总结这篇文章的内容并给出一个标题”。工具会自动调用 “fetch” MCP 服务,生成效果如下图所示:


接着我们配合图片生成的 MCP 服务,要求为生成的内容配上图片。输入指令 “Render the final article content in the tailwindcss + html format.”(用 tailwindcss + html 格式渲染最终的文章内容)。


这时,工具会自动调用 “fal ai” MCP 服务,最终按照指令要求生成 html 页面内容。本例中,我们复制这段代码,在线运行 html 进行展示,可以看到内容中已经加上了图片,大致如下:

五、常见问题与解决方法

1. 无法连接 MCP 服务器

如果 MCP 服务器显示为不可用,可以尝试以下解决方法:

检查环境依赖:确保 Node.js、Git 等必要组件已正确安装。

在终端中执行命令:将 MCP 命令复制到系统终端中执行,查看是否有详细的报错信息。

重启 Cursor:彻底关闭并重启 Cursor。

更新 Cursor:确保你使用的是最新版本的 Cursor。

2. 命令执行超时

有时 MCP 配置依赖其他包环境,下载需要一定时间。如果未在 Cursor 规定的时间内完成连接,就会报错。此时需要:

将命令复制到命令行终端

在终端执行成功后,回到 Cursor 刷新状态。

3. MCP 工具不显示

如果配置好的 MCP 工具没有显示在调用列表中,可能是因为:

当前不在 Agent 模式:确保在聊天界面切换到 Edit(原 Composer)模式。

工具列表未更新:尝试刷新 MCP 服务器列表。

服务器未启动:检查 MCP 服务器状态是否处于活跃状态。

总结

通过本教程,我们详细介绍了 Cursor 编辑器的安装步骤与 MCP 服务的配置方法。MCP 协议的出现为 AI 工具提供了强大的扩展能力,让 Cursor 不仅是一款代码编辑器,更是一个功能丰富的 AI 开发环境。

随着 MCP 生态的不断发展,将有越来越多的服务接入,进一步提升 Cursor 的功能。希望本教程能帮助你快速上手 Cursor 与 MCP,提高开发效率。

请记住,使用 MCP 功能时必须在 Cursor 的 Composer/Edit 模式下操作,这样才能成功调用 MCP 工具。如果遇到问题,可以尝试本教程提供的常见问题解决方法,或参考官方文档获取更多支持。

MCP 客户端入门教程系列

《适合初学者的 MCP 入门指南,读完本文即可从零学会使用 MCP 服务。》

《MCP 客户端入门教程:Cherry Studio 的安装与配置》

《MCP 客户端入门教程:ChatWise 的安装与配置》

《MCP 客户端入门教程:Cursor 的安装与配置》

《MCP 客户端入门教程:trae 的安装与配置》

《MCP 客户端入门教程:Claude 的安装与配置》