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 执行