Cursor Rust 工具

一个 MCP 服务器，允许 Cursor 中的 LLM 访问 Rust Analyzer、Crate 文档和 Cargo 命令。

包含一个用于配置的 UI。

功能

目前，各种 AI 代理无法让 AI 访问来自 LSP 的 Rust 类型信息。这是一个障碍，因为 LLM 必须推断潜在的类型，而不是直接看到类型。

此外，关于依赖项（例如 tokio）的唯一信息是它们所训练的内容，这些内容已经过时，并且可能适用于不同的版本。这可能导致各种问题。

Cursor Rust Tools 通过模型上下文协议 (MCP) 提供这些功能。

• 获取 crate 的文档，或 crate 中特定符号的文档（例如 tokio 或 tokio::spawn）
• 获取文件中特定符号的悬停信息（类型、描述）
• 获取文件中特定符号的所有引用列表
• 获取文件中符号的实现（检索包含实现的整个文件）
• 仅通过名称在项目中查找类型，并返回悬停信息
• 获取 cargo test 的输出
• 获取 cargo check 的输出

工作原理

对于 LSP 功能 src/lsp，它会启动一个新的 Rust Analyzer，该分析器会像在编辑器中运行的那样索引你的代码库。我们无法查询在编辑器中运行的那个，因为 Rust Analyzer 只能被单个消费者使用（例如，open document 操作需要按正确的顺序执行 close document 等）。

对于文档，它将运行 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. 将 project-dir/.cursor/mcp.json 添加到你的项目。Cursor Rust Tools UI 有一个按钮可以为你执行此操作。在没有 UI 的情况下运行它也会在终端中显示 mcp.json 的内容。
2. 保存该文件后，Cursor 会立即检测到已添加新的 MCP 服务器，并要求你启用它。（在右下角的对话框中）。
3. 你可以检查 Cursor 设置（在 MCP 下）以查看它是否正常工作
4. 要进行测试，请确保在当前的 Chat 中选择了 Agent Mode。然后你可以要求它使用其中一个新工具，例如 cargo_check 工具。
5. 你可能需要添加 cursor 规则，以告诉 LLM 尽可能优先使用这些工具。我仍在对此进行试验。

所有 mcp.json 的内容都是相同的。Cursor Rust Tools 通过文件路径确定正确的项目

未完成事项

• [ ] 创建一个 Zed 扩展以允许使用此工具
• [ ] 正确关闭，没有错误
• [ ] 删除项目现在有点脆弱（在 UI 中）
• [ ] 公开更多 LSP 命令
• [ ] 允许 LLM 执行 Grit 操作