agent mcp list
列出已配置的 MCP 服务器及其状态(已连接/已断开、来源、传输方式)。
agent mcp list 是 Cursor CLI 的一个终端子命令,直接在 shell 中调用。它会打开一个交互式菜单,列出所有已配置的 MCP 服务器,并显示每个服务器的名称、连接状态(已连接/已断开)、配置来源(项目配置或全局配置)以及传输方式(stdio、HTTP 或 SSE)。
底层配置保存在 .cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(全局),根据文档说明,其结构与 Cursor IDE 中的配置相同。
在交互模式下,/mcp list 会在正在运行的会话内以分页器的形式提供同样的概览,还可以直接在菜单中完成登录、启用以及浏览工具等操作。因此 agent mcp list 是用于会话之外场景的终端版本,比如在启动任务前通过脚本检查哪些服务器当前是可用的。
✅ 什么时候用?
任务开始前检查服务器状态
执行 agent mcp list,查看所需的服务器是否已连接
确认某个服务器的配置来源
打开 agent mcp list,检查某个服务器是项目级配置还是全局配置
⛔ 什么时候不该用?
想查看某个服务器的工具参数
agent mcp list 只显示服务器状态,不显示工具的详细信息。
更好的选择: 针对特定服务器使用 agent mcp list-tools <identifier>
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
- Cursor 官方文档——CLI MCP ↗ cursor.com
更多命令 · Cursor CLI