跳转到主要内容

概览

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 <标识>

在 Agent 中使用 MCP

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

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

# 使用 cursor-agent——在合适时会自动调用 MCP 工具
cursor-agent --prompt "打开 google.com,并对搜索页面进行截图"
CLI 遵循与编辑器相同的配置优先级(项目 → 全局 → 嵌套),会自动从父目录中发现配置。
I