使用 rust-docs MCP,随时获取 Rust 文档

发布: (2025年12月17日 GMT+8 00:59)
4 min read
原文: Dev.to

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?”

你也可以提出与版本相关的问题,例如:

“在 axum 0.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"
      ]
    }
  }
}

HTTP Endpoint (handy for one‑off calls/scripts)

Back to Blog

相关文章

阅读更多 »