使用 rust-docs MCP,随时获取 Rust 文档
Source: Dev.to
docs.rs 是信息的宝库,但在其中搜索有时会拖慢你的开发进程。
rust-docs 是一个 Mastra MCP 服务器,向你的 AI 助手直接提供 docs.rs 上的 Rust 文档。
GitHub 仓库:
The Problem
在使用 AI 编码助手时,它们往往依赖于训练数据,而这些数据可能已经过时或缺乏对特定 crate 版本的了解。这会导致“幻觉”——看起来正确的代码却使用了不存在的 API 或错误的语法。
在 Rust 中,细微的版本差异(或 feature 标记)会影响可用的类型和方法,使得这些幻觉尤其痛苦。
The Solution: rust-docs
rust-docs 将你的 AI 编辑器连接到 docs.rs 上的实时文档。这意味着:
- 最新信息 – 你的 AI 可以查找你所使用的特定 crate 版本中函数或结构体的准确签名。
- Crate 探索 – 在不离开 IDE 的情况下发现新 crate 和模块。
- 专家协助 – 通过官方文档,AI 成为更可靠的 Rust 专家。
What to Ask For (to Get the Best Results)
你越“指名道姓”,工具就越容易检索到正确的文档:
- Crate + 模块路径: “查找
reqwest::ClientBuilder” - 宏语法: “展示
tokio::select!示例以及常见陷阱” - Trait 约束: “
?在我的错误类型上需要什么 trait?”
你也可以提出与版本相关的问题,例如:
“在
axum0.7 中,推荐的 JSON 提取和校验方式是什么?”
即使助手事先不知道你的版本,rust-docs 也能让它验证实际存在的内容。
How to Use
该服务器作为 MCP 工具提供。将在兼容的编辑器中进行配置,即可立即开始查询 Rust 文档。
示例查询
- “如何使用
tokio::select!宏?” - “
serde中有哪些可用的 feature?”
AI 将从 docs.rs 抓取相应页面,给出精准答案。
When It Shines
- Crate 升级 – 在不来回切换标签页的情况下检查 API 变化。
- Feature 标记 – 确认某个类型/方法是否受 feature 控制。
- 宏 – 从真实文档中获取确切的调用模式(而不是流言)。
Wrapping Up
rust-docs 帮助弥合 Rust 丰富文档与 AI 助手即时上下文之间的鸿沟。它是一个小工具,却能在日常 Rust 开发中产生巨大影响。
Quick Setup (Mastra Cloud)
SSE Endpoint (best for editors that keep a persistent connection)
Example Config (npx + mcp‑remote)
{
"mcpServers": {
"rust-docs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://rust-docs.mastra.cloud/api/mcp/rust-docs/sse"
]
}
}
}