Cursor Rust Tools

🚀 Cursor Rust 工具

Cursor Rust 工具是一個基於 MCP 的服務器，它允許 Cursor 中的大語言模型（LLM）訪問 Rust 分析器、crate 文檔和 Cargo 命令，還配備了用於配置的用戶界面（UI）。

🚀 快速開始

Cursor Rust 工具能讓 Cursor 中的 LLM 訪問 Rust 分析器、crate 文檔和 Cargo 命令。以下是使用該工具的快速步驟：

1. 安裝工具：

cargo install --git https://github.com/terhechte/cursor-rust-tools

2. 運行工具：
   • 帶 UI 運行：

cursor-rust-tools

- 不帶 UI 運行（前提是已設置好 `~/.cursor-rust-tools`）：

cursor-rust-tools --no-ui

3. 配置 Cursor：
   • 在項目目錄中添加 .cursor/mcp.json 文件。
   • 保存文件後，Cursor 會檢測到新的 MCP 服務器並提示啟用。
   • 在 Cursor 設置（MCP 下）檢查是否正常工作。
   • 測試時，選擇當前聊天中的 Agent Mode，讓 LLM 執行新工具。
   • 可添加 Cursor 規則以優先使用這些工具：規則說明

✨ 主要特性

目前，各類 AI 代理無法讓 LLM 訪問 Rust 類型信息，導致 LLM 需推理潛在類型，且對於依賴項只能基於訓練時可能過時的數據，易引發問題。而 Cursor Rust Tools 通過 Model Context Protocol (MCP) 為 LLM 提供了以下信息：

• 獲取特定 crate 或其符號的文檔（例如 tokio 或 tokio::spawn）
• 獲取文件中特定符號的懸停信息（類型、描述）
• 獲取文件中特定符號的所有引用
• 獲取符號的實現（檢索包含實現的整個文件）
• 通過名稱查找文件中的類型，並返回懸停信息
• 獲取 cargo test 的輸出
• 獲取 cargo check 的輸出

🔧 技術細節

工作原理

• LSP 功能：為了實現 LSP 功能，src/lsp 會啟動一個新的 Rust Analyzer，該分析器會對代碼庫進行索引，就像在編輯器中運行一樣。由於 Rust Analyzer 只能供單個消費者使用（例如 打開文檔 操作需要正確的 關閉文檔 順序等），所以不能查詢編輯器中正在運行的分析器。
• 文檔功能：對於文檔功能，它會運行 cargo docs，然後將本地的 HTML 文檔解析為 Markdown。這些信息會存儲在項目根目錄中的 .docs-cache 文件夾中。

📦 安裝指南

安裝工具

cargo install --git https://github.com/terhechte/cursor-rust-tools

運行工具

帶 UI 運行

cursor-rust-tools

這將啟動一個 UI，您可以在其中添加項目、安裝 mcp.json 並查看活動。

不帶 UI 運行

如果已經設置好了 ~/.cursor-rust-tools，也可以通過以下命令運行：

cursor-rust-tools --no-ui

📚 詳細文檔

配置工具

除了使用 UI 創建配置外，您還可以自己設置 ~/.cursor-rust-tools：

[[projects]]
root = "/Users/terhechte/Developer/Rust/example1"
ignore_crates = []

[[projects]]
root = "/Users/terhechte/Developer/Rust/example2"
ignore_crates = []

ignore_crates 是您不想索引文檔的 crate 依賴項名稱列表，例如，因為它們太大。

配置 Cursor

一旦應用程序運行，您可以按以下步驟配置 Cursor 使用它：

1. 在項目目錄中添加 .cursor/mcp.json 文件。Cursor Rust Tools 的 UI 有一個按鈕可以為您完成此操作。帶 UI 運行時，終端會顯示 mcp.json 內容。
2. 只要保存該文件，Cursor 將檢測到一個新的 MCP 服務器已添加，並提示您啟用它（在右下角的對話框中）。
3. 您可以在 Cursor 設置（在 MCP 下）檢查是否正確工作。
4. 測試時，請確保選擇了當前聊天中的 Agent Mode。然後可以讓 LLM 執行其中一個新工具，例如 cargo_check 工具。
5. 您可能希望添加 Cursor 規則以告訴 LLM 儘可能優先使用這些工具

注意：所有 mcp.json 內容相同。Cursor Rust Tools 根據文件路徑確定正確的項目。

📄 待辦事項

• [ ] 創建 Zed 擴展以允許使用此功能
• [ ] 實現無錯誤的正常關閉
• [ ] 當前移除項目在 UI 中有點脆弱
• [ ] 暴露更多 LSP 命令
• [ ] 允許 LLM 執行