MCP客户端入门使用教程之Cursor安装配置（未验证）

今天AIbase为大家带来一篇详细的MCP客户端入门使用教程，重点介绍Cursor编辑器的安装与MCP服务的配置过程。通过本教程，您将了解如何快速设置Cursor并将其连接到MCP服务器，以充分利用AI辅助编程的强大功能。

一、MCP简介

MCP（Model Context Protocol）是由Anthropic(Claude母公司)于2024年11月推出的开放标准协议，它为开发者提供了一个强大的工具，能够在数据源和AI驱动工具之间建立安全的双向连接。

简单来说，如果将AI比作一台只能处理文字的智能设备，那么MCP就像给它装上了“万能插头”，让它能直接读取你的电脑文件、查询数据库，甚至操作GitHub提交代码，以及调用各种第三方平台等功能。

目前，MCP已被Claude桌面端、Cline、Continue、Cursor、Windsurf等多款AI工具广泛应用。

二、Cursor安装步骤

1. 下载Cursor

首先，我们需要从Cursor官网下载最新版本的软件。

  1. 访问Cursor官方网站: https://www.cursor.com/cn/downloads

Cursor下载页面

  1. 根据您的操作系统选择对应的版本进行下载:
    • Windows用户: 选择"Windows10/11（x64）"
    • Mac用户: 根据处理器选择对应版本（Universal/Arm64/x64）
    • Linux用户: 选择.AppImage对应版本

2. 安装Cursor

Windows安装步骤:

  1. 双击下载的安装文件（通常是.exe格式）
  2. 等待安装程序自动完成安装过程（Cursor通常不需要选择安装目录）
  3. 安装完成后，Cursor会自动启动并显示配置界面

Cursor安装界面

Mac安装步骤:

  1. 打开下载的.dmg文件
  2. 将Cursor应用拖入Applications文件夹
  3. 在应用程序中找到并启动Cursor

3. 初始配置

首次启动Cursor时，需要进行以下基础配置:

  1. 键盘布局选择:根据个人习惯选择Vim或Emacs布局，如果不熟悉可选择默认的"None"
  2. 主题选择:选择明亮或暗色主题
  3. 隐私设置:如果不希望分享数据给Cursor，可以选择Privacy Mode
  4. 登录账户:使用GitHub、Google或邮箱创建/登录Cursor账户

Cursor界面配置

4. 中文界面设置（可选）

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

  1. 打开Cursor后，点击左下角齿轮图标打开设置
  2. 在搜索框中输入"language"
  3. 在"Configure Display Language"下选择"zh-cn"
  4. 点击"Restart"重启Cursor应用

三、MCP配置步骤

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

1. 基础环境准备

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

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

2. 访问Cursor MCP设置

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

    • 点击左下角齿轮图标
    • 使用快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板，搜索"Cursor Settings"

  2. 在左侧菜单中找到并点击"Features" > “MCP”

Cursor MCP设置界面

3. 添加MCP服务器

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

添加MCP服务器

需要填写以下信息:

  1. Name: 为MCP服务器指定一个易辨识的名称
  2. Transport Type: 选择传输类型
    • stdio: 标准输入输出（适用于命令行工具）
    • sse: 服务器发送事件（适用于Web服务）
  3. Command/URL: 根据传输类型填写相应信息
    • 对于 stdio 类型，输入可执行命令
    • 对于 sse 类型，输入服务器URL

4. 配置Web搜索MCP服务（示例）

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

  1. 访问Smithery平台: https://smithery.ai，搜索"Web Research"
  2. 或直接访问: https://smithery.ai/server/@mzxrai/mcp-webresearch
  3. 在"Installation"区域找到并复制Cursor安装命令:
    npx -y @smithery/cli@latest run @mzxrai/mcp-webresearch --config "{}"
  4. 在Cursor的MCP设置中添加新服务器:
    • 名称: Web Search
    • 类型: command
    • 命令: 粘贴上面复制的命令

MCP服务器列表

5. 验证MCP服务器状态

添加完成后，MCP服务器应显示为可用状态。成功配置的MCP服务器会在列表中显示绿色指示灯或勾号。

四、使用MCP功能

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

1. 使用限制

重要提示:目前MCP工具并非适用于所有模型，仅在Composer中的Agent处可用。

在新版Cursor中，Composer被移至聊天框的左下角，并改名为"Edit"。

2. 测试MCP功能

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

  1. 在聊天框中点击左下角的"Edit"按钮切换到Agent模式
  2. 输入需要使用MCP工具的查询，例如:
    帮我使用Web Search查找关于MCP协议的最新信息
  3. 观察Cursor是否调用了相应的MCP工具并返回结果
  4. 成功调用MCP工具时，会显示"Called MCP tool"的提示

MCP功能使用示例

五、常见问题及解决方法

1. MCP服务器连接失败

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

  1. 检查环境依赖:确保Node.js、Git等必要组件已正确安装
  2. 终端执行命令:将MCP命令复制到系统终端中执行，查看是否有详细的错误信息
  3. 重启Cursor:完全关闭并重新启动Cursor
  4. 更新Cursor:确保使用最新版本的Cursor

2. 命令执行超时

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

  1. 将命令复制到命令行终端
  2. 在终端执行成功后再回到Cursor刷新状态

3. MCP工具不显示

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

  1. 当前不在Agent模式:确保在聊天界面中切换到Edit（原Composer）模式
  2. 工具列表未更新:尝试刷新MCP服务器列表
  3. 服务器未启动:检查MCP服务器状态是否为活跃状态

六、高级MCP配置示例

1. 思维链MCP配置

思维链MCP是一个受欢迎的MCP服务，可以帮助AI更有条理地思考问题。配置步骤如下:

  1. 使用npm安装项目:

    npm install -g @modelcontextprotocol/server-sequential-thinking

  2. 在

    YiAI团队

    YiAI团队

    AI大模型技术专家团队

    YiAI团队是一支专注于AI大模型应用的技术团队，由来自国内外知名科技公司的AI专家组成。 我们致力于为企业和开发者提供高质量、低成本的AI大模型API服务，涵盖文本生成、对话交互、 内容理解、知识问答等多个领域。团队拥有丰富的大规模语言模型开发和应用经验，深入理解 企业在AI落地过程中的实际需求和技术痛点。