概览

Cursor CLI 支持 Model Context Protocol(MCP) 服务器,让你把外部工具和数据源接入 cursor-agentCLI 中的 MCP 与编辑器共用同一套配置——你已配置的任何 MCP 服务器都能在两者之间无缝使用。

了解 MCP

第一次接触 MCP?查看完整指南,了解配置、身份验证,以及可用的服务器

CLI 命令

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

列出已配置的服务器

查看所有已配置的 MCP 服务器及其当前状态:
cursor-agent mcp list
将显示:
  • 服务器名称和标识符
  • 连接状态(已连接/未连接)
  • 配置来源(项目或全局)
  • 传输方式(stdio、HTTP、SSE)

列出可用工具

查看特定 MCP 服务器提供的工具:
cursor-agent mcp list-tools <identifier>
将显示:
  • 工具名称和描述
  • 必需和可选参数
  • 参数类型和约束

登录 MCP 服务器

对在 mcp.json 中配置的 MCP 服务器进行认证:
cursor-agent mcp login <identifier>

禁用 MCP 服务器

将 MCP 服务器从本地已批准列表中移除:
cursor-agent mcp disable <identifier>

在 Agent 中使用 MCP

在你配置好 MCP 服务器之后(参见主 MCP 指南了解设置),cursor-agent 会在与你的请求相关时自动发现并使用可用工具。
# 查看可用的 MCP 服务器
cursor-agent mcp list

# 查看某个特定服务器提供的工具
cursor-agent mcp list-tools playwright

# 直接用 cursor-agent——在有用时会自动调用 MCP 工具
cursor-agent --prompt "Navigate to google.com and take a screenshot of the search page"
CLI 遵循与编辑器相同的配置优先级(项目 → 全局 → 嵌套),会自动从父级目录发现配置。