概述¶
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 服務器