MCP客户端入门使用教程之Cursor安装配置
发布时间 : 2025-05-06
浏览量 : 4.9K

这是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/

QQ_1745226315277.png

2.根据您的操作系统会自动提供对应的版本进行下载,大致参考如下:

Windows用户:选择Windows10/11(x64)

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

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

2. 安装Cursor

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

QQ_1745226745582.png

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

image.png

3. 初始配置

键盘布局选择:根据个人习惯选择Vim或Emacs布局,如果不熟悉可选择默认的"None",主题选择:选择明亮或暗色主题。

隐私设置:如何不希望分享数据给Cursor,可以选择Privacy Mode。

QQ_1745228744685.png

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

如果希望使用中文界面,可以按照以下步骤操作:

1)使用拓展程序设置中文版

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

QQ_1745228905710.png

2)配置语言设置中文版

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

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

QQ_1745228999451.png

三、MCP配置步骤

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

1. 基础环境准备

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

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

2. 访问Cursor MCP设置

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

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

QQ_1745302465822.png

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


3. 添加MCP服务器

在MCP设置页面,点击"+ Add New MCP Server"按钮,将出现配置窗口:

QQ_1745302744173.png

点击添加之后,会出现一个编辑框,输入MCP 服务的配置代码。

QQ_1745302825902.png

官方示例:这里MCP 配置文件使用具有以下结构的 JSON 格式:

QQ_1745302995919.png

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

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

访问魔塔社区MCP广场:https://modelscope.cn/mcp,比如选择"fetch网页内容抓取"这个服务:

QQ_1745305335410.png

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

QQ_1745305225940.png

把命令字段复制进编辑器然后保存即可,这样上面示例中的"fetch网页内容抓取"MCP服务就添加成功了。

QQ_1745305407176.png

5. 验证MCP服务器状态

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

QQ_1745305461860.png

类似的方法,AIbase在本示例转给你还添加了另外一个可以生成图片的MCP服务“fal ai”,后面可以搭配使用。

四、使用MCP功能

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

1. 使用限制

重要提示:目前MCP工具并非适用于所有模型,仅在Composer中的Agent处可用。在新版Cursor中,Composer被移至聊天框的左下角,并改名为"Edit"。

2. 测试MCP功能

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

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

QQ_1745310904200.png

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线运行展示,可以看到已经为内容配上图片了,大致如下:

QQ_1745314635746.png

五、常见问题及解决方法

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安装配置

MCP客户端入门使用教程之ChatWise安装配置

MCP客户端入门使用教程之Cursor安装配置

MCP客户端入门使用教程之trae安装配置

MCP客户端入门使用教程之Claude安装配置


AIbase
智启未来,您的人工智能解决方案智库
简体中文