概述¶
Cursor 命令行界面支持 模型上下文协议 (MCP) 服务器,可将外部工具和数据源连接到 agent。CLI 中的 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 服务器