《Cursor文档》-MCP

概述

Cursor 命令行界面支持 模型上下文协议 (MCP) 服务器,可将外部工具和数据源连接到 agentCLI 中的 MCP 与编辑器共用同一配置——您配置的任何 MCP 服务器均可在两者中使用。

了解 MCP

刚接触 MCP?阅读有关配置、身份验证和
可用服务器的完整指南

CLI 命令

使用 agent mcp 命令管理 MCP 服务器

列出已配置的服务器

查看所有已配置的 MCP 服务器及其当前状态:

agent mcp list

这会打开一个交互式菜单,您可以在其中一览并浏览、启用和配置 MCP 服务器。列表会显示:

  • 服务器名称和标识符
  • 连接状态 (已连接/未连接)
  • 配置来源 (项目级或全局)
  • 传输方式 (stdio、HTTP、SSE)

您也可以在交互模式下使用 /mcp list 斜杠命令打开相同的界面。

列出可用工具

查看指定 MCP 服务器提供的工具:

agent mcp list-tools <identifier>

这将显示:

  • 工具名称和描述
  • 必填和可选参数
  • 参数类型和约束

登录 MCP 服务器

mcp.json 中配置的 MCP 服务器进行认证:

agent mcp login <identifier>

命令行界面采用简化的登录流程,并自动处理回调。登录完成后,智能体即可立即访问已认证的 MCP。

启用 MCP 服务器

启用 MCP 服务器:

agent mcp enable <identifier>

这会将服务器添加到本地已批准列表。

禁用 MCP 服务器

禁用 MCP 服务器:

agent mcp disable <identifier>

已禁用的服务器不会加载,也不会请求批准。

CLI 命令和 /mcp list-tools 支持名称中含空格的 MCP 服务器。

在智能体中使用 MCP

配置 MCP 服务器后 (设置方法请参阅主 MCP 指南) ,agent 会自动发现并在与您的请求相关时使用可用工具。

# 查看可用的 MCP 服务器
agent mcp list

# 查看指定服务器提供的工具
agent mcp list-tools playwright

# 使用智能体:它会在有帮助时自动使用 MCP 工具
agent -p "Navigate to google.com and take a screenshot of the search page"

# 自动批准所有 MCP 服务器(跳过批准提示)
agent --approve-mcps "query my database for recent errors"

命令行界面遵循与编辑器相同的配置优先级 (项目 → 全局 → 嵌套) ,并会自动发现父目录中的配置。

MCP 与 ACP

如果希望 Cursor 调用外部工具和服务,请使用 MCP。如果希望构建通过协议消息直接与 Cursor 命令行界面通信的自定义客户端,请使用 ACP

相关内容

MCP 概览

MCP 完整指南:设置、配置和身份验证

可用 MCP 工具

浏览可直接使用的预构建 MCP 服务器

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜