这是MCP客户端入门使用教程系列第二篇:《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用户:选择Windows10/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”,按下回车键。
在弹出的语言配置页面中,选择“中文(简体)”作为显示语言。点击“保存”按钮,重启Cursor软件,即可看到软件界面已经成功切换为中文。
三、MCP配置步骤
要在Cursor中使用MCP功能,需要先完成MCP服务器的配置。以下是详细步骤:
1. 基础环境准备
在配置MCP之前,确保您的系统中已安装以下组件:
- Node.js:版本≥14(验证方法:在命令行中输入
node -v
查看版本号) - Git:最新稳定版本
- Python:部分MCP服务需要Python3.10或更高版本(可选)
2. 访问Cursor MCP设置
打开Cursor设置,可以通过以下两种方式:
1)点击右上角齿轮图标也就是“设置”选项,在出现的左侧菜单中找到并点击“MCP”。
2)在搜索框中,使用快捷键Ctrl+Shift+P
(Windows/Linux)或Cmd+Shift+P
(Mac)打开命令面板,搜索"Cursor Settings",在左侧菜单中找到并点击“MCP”。
3. 添加MCP服务器
在MCP设置页面,点击"+ Add New MCP Server"按钮,将出现配置窗口:
点击添加之后,会出现一个编辑框,输入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服务,要求为生成的内容配图,指令输入“最终文章内容使用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入门指南,看完这篇0基础学会使用MCP服务》
《MCP客户端入门使用教程之Cherry Studio安装配置》