Cursor 2.5 与 MCP 服务完全指南:让 AI 助手连接整个世界

结合 Cursor 2.5 新特性,一文搞懂什么是 MCP、如何配置、以及有哪些值得一试的 MCP 服务。


一、Cursor 2.5 带来的变化:插件与「组件」

2026 年 2 月,Cursor 2.5 正式发布,除了异步子代理沙箱网络控制等能力外,最显眼的是 Cursor 插件市场(Marketplace)。插件可以把多种能力打包成「一次安装」:

  • Rules(规则)
  • Skills(技能)
  • Agents / Subagents(代理 / 子代理)
  • Commands(命令)
  • MCP Servers(MCP 服务器)
  • Hooks(钩子)

这些在 Cursor 里被统称为 Components(组件)MCP 服务器正是其中负责「把外部工具和数据源接进 Cursor」的那一类。下面我们就专注把 MCP 说清楚。


二、MCP 是什么?

MCP(Model Context Protocol) 是一套开放协议,用来规范「应用如何把上下文和工具提供给大模型」。可以把它理解成:

  • 对 Cursor 来说:一套标准的「插件接口」——谁实现了 MCP,谁就能给 Agent 提供工具(Tools)资源(Resources)
  • 对你来说:不用改 Cursor 本身,只要配置一个 MCP 服务器,Agent 就能查 GitHub、控浏览器、连数据库、发 Slack……能力按需扩展。

所以:MCP 服务器 = 用 MCP 协议把「外部能力」暴露给 Cursor Agent 的程序或服务。


三、两种连接方式:本地进程 vs 远端服务

MCP 服务器既可以跑在你本机,也可以跑在远端;Cursor 的配置方式因此分为两种。

1. 本地:command + args(stdio)

Cursor 根据你配置的命令 + 参数,在你本机启动一个进程,通过标准输入/输出(stdio) 和这个进程通信。

  • 谁在跑:你电脑上的一个进程(例如由 npx -y @playwright/mcp@latest 启动)。
  • 配置长什么样command + args,必要时加 env
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}
  • 第一次运行:npx 会从 npm 下载对应包并执行;之后同版本会走缓存,一般不再重复下载。
  • 适合:Playwright、GitHub(docker)、Stripe、Firecrawl、MongoDB 等通过一条命令就能跑起来的服务。

2. 远端:url(HTTP / SSE)

MCP 服务已经部署在某一台机器上,Cursor 通过网址去连它,用 HTTP 或 SSE 通信。

  • 谁在跑:别人或你自己部署好的服务(例如 Slack、Notion、Figma 的官方 MCP 端点)。
  • 配置长什么样url,有的需要 headers 或 OAuth。
{
  "mcpServers": {
    "slack": {
      "url": "https://mcp.slack.com/mcp"
    }
  }
}
  • 适合:Slack、Notion、Figma、Vercel、Sentry 等已有线上端点的服务。

四、在 Cursor 里怎么配置 MCP?

配置位置

范围 路径 说明
项目级 项目根目录 .cursor/mcp.json 仅当前项目可用
全局 用户目录 ~/.cursor/mcp.json 所有项目可用

项目级会覆盖同名的全局配置。

方式一:界面配置

  1. 打开 Cursor Settings界面(点击界面右上角的齿轮图标)。
  2. 选择 Tools & MCP 标签页
  3. 点击 Add new MCP server,按提示填名称、命令或 URL。
    在这里插入图片描述

保存后,新开的 Agent 对话会自动加载这些 MCP。

方式二:直接写 mcp.json

在项目或用户目录下创建/编辑 .cursor/mcp.json,例如:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"]
    }
  }
}

需要 API Key 时用环境变量,不要写死密钥:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GITHUB_TOKEN}"
      }
    }
  }
}

五、怎么确认 MCP 已经用上?

  1. 设置里看:Features → MCP 里能看到对应服务器,且处于开启状态。
  2. 对话里试:新开一个 Agent(Composer) 对话,用自然语言触发能力(例如:「用浏览器打开 https://example.com 并截一张图」)。若 Agent 的步骤里出现 browser_navigatebrowser_take_screenshot 等工具调用,说明 MCP 已生效。
  3. 看输出/日志:若没反应,到「查看 → 输出」里选 Cursor/MCP 相关通道,看是否有连接错误或命令找不到等报错。

注意:只有 Agent(Composer)会调用 MCP 工具,普通 Chat 或 Tab 补全不会用。

在这里插入图片描述
这样就表示用上了MCP服务~~~


六、常用 MCP 服务一览

按用途简单分个类,便于按需选用(完整列表见 Cursor 官方文档)。

浏览器与前端

  • Playwright:浏览器自动化、截图、端到端测试。npx -y @playwright/mcp@latest(需先 npx playwright install 安装浏览器)。
  • shadcn/ui:浏览/搜索/安装 shadcn 组件。npx shadcn@latest mcp
  • Figma:读设计稿。SSE:https://mcp.figma.com/mcp 。

代码与协作

  • GitHub:仓库、Issue、PR 等。需 Docker + GITHUB_PERSONAL_ACCESS_TOKEN
  • Linear:任务与项目管理。SSE + OAuth。
  • Atlassian:Jira、Confluence。SSE。

文档与知识

  • MS Learn Docs:微软官方文档。SSE。
  • AWS Documentation:AWS 文档与推荐。stdio。
  • Firecrawl:网页抓取、转结构化内容。npx -y firecrawl-mcp

数据库与后端

  • MongoDBnpx -y mongodb-mcp-server
  • Supabase / Prisma / Neon:多为 SSE,部分需 OAuth。

部署与运维

  • Vercel / Netlify / Railway:项目管理与部署。
  • Terraform:HashiCorp 官方 MCP,需 Docker。

支付与 API

  • Stripenpx -y @stripe/mcp --tools=all
  • Postman:集合与请求管理。

监控与安全

  • Sentry:错误与性能监控。SSE。
  • Snyk / Semgrep:依赖与代码安全扫描。

在 Cursor 2.5 的 插件市场(cursor.com/marketplace) 里,也可以按分类浏览和安装包含 MCP 的插件,实现「一键安装多种组件」。


七、Playwright MCP 小贴士

很多人第一个装的 MCP 是 Playwright,这里单独说两点:

  • 浏览器从哪来npx playwright install 安装的是 Playwright 自带的 Chromium 等浏览器,和你本机已装的 Edge/Chrome 不是同一套;Agent 控制的是 Playwright 下载的那份,不能直接复用系统浏览器。
  • 安装顺序:若在项目里用,建议先 npm install @playwright/test(或项目依赖里已有 playwright),再在同一目录下执行 npx playwright install,可避免 WARNING 和版本错位。若只为 Cursor MCP 用、不在项目里写 Playwright 代码,在任意目录跑一次 npx playwright install 也可,浏览器会进缓存供 MCP 使用。

八、小结

  • Cursor 2.5 用插件市场把 Rules、Skills、MCP、Hooks 等打成「组件」,MCP 是其中扩展外部工具与数据的一类。
  • MCP 服务器:按 MCP 协议暴露工具/资源给 Cursor Agent;可本机 stdio(command + args)或远端 HTTP/SSE(url)。
  • 配置:在 .cursor/mcp.json 或设置 → Features → MCP 里添加;Agent 对话里用自然语言即可触发,无需记工具名。
  • 验证:新开 Agent 对话,说一句需要该能力的指令,看是否出现对应工具调用或结果。

用好 MCP,相当于给 Cursor 接上 GitHub、浏览器、数据库、文档和运维工具,让 AI 助手真正「连上你的世界」。


额外补充:playwright MCP服务提供了哪些功能?

在这里插入图片描述

这些是 Playwright MCPnpx -y @playwright/mcp@latest)提供的浏览器自动化能力,可以理解为「在浏览器里替你做各种操作」的工具,大致分几类:


导航与页面

  • browser_navigate:打开指定网址(例如打开你的 CSDN 博客)
  • browser_navigate_back:后退到上一页
  • browser_tabs:查看/切换/新建/关闭标签页
  • browser_close:关闭当前页面或浏览器

截图与结构

  • browser_take_screenshot:对当前页面截屏并保存
  • browser_snapshot:获取当前页面的可访问性结构(DOM/可点击元素等),便于后续用 ref 去点击、输入

交互

  • browser_click:点击某个元素
  • browser_type:在输入框里输入文字
  • browser_fill_form:一次性填多个表单项
  • browser_hover:鼠标悬停
  • browser_drag:拖拽(从一个元素拖到另一个)
  • browser_select_option:在下拉框里选某一项
  • browser_press_key:按键盘键(如 Enter、Esc)
  • browser_file_upload:选择并上传文件

弹窗与脚本

  • browser_handle_dialog:处理 alert / confirm / prompt 等弹窗(接受/取消/输入内容)
  • browser_evaluate:在页面里执行一段 JavaScript
  • browser_run_code:在 Playwright 环境里跑一段脚本(例如 async (page) => { ... }

调试与监控

  • browser_console_messages:看控制台输出(log、error 等)
  • browser_network_requests:看当前页发出的网络请求
  • browser_wait_for:等待某段文字出现/消失,或等待一定时间
  • browser_resize:改变浏览器窗口宽高
  • browser_install:安装/准备 Playwright 用的浏览器(例如 Chromium),没装时先调这个

总结:这一套就是「用 MCP 控制浏览器」的 API——能打开网页、点击、输入、上传、截屏、看控制台和网络等,适合做自动化测试、简单爬取或演示流程。「用浏览器打开博客并截一张图」就是用 browser_navigate + browser_take_screenshot 来实现的。

参考

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐