MCP
概述
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。