mcp-rustdoc 3.0.0 → 3.1.0

package/README.md

@@ -1,6 +1,6 @@
 # mcp-rustdoc
 
-An MCP server that gives AI assistants deep access to the Rust ecosystem. It scrapes docs.rs (and `doc.rust-lang.org` for `std`/`core`/`alloc`) with surgical DOM extraction (cheerio) and queries the crates.io API, exposing seven tools that cover everything from high-level crate overviews to individual method signatures, feature gates, trait impls, and code examples. Responses are cached in memory (5-minute TTL) to avoid redundant fetches.
+An MCP server that gives AI assistants deep access to the Rust ecosystem. It scrapes docs.rs (and `doc.rust-lang.org` for `std`/`core`/`alloc`) with surgical DOM extraction (cheerio) and queries the crates.io API, exposing nine tools that cover everything from high-level crate overviews to individual method signatures, feature gates, trait impls, and code examples. Responses are cached in memory (5-minute TTL) to avoid redundant fetches.
 
 ## Tools
 
@@ -13,6 +13,8 @@ An MCP server that gives AI assistants deep access to the Rust ecosystem. It scr
 | `lookup_crate_item` | Item detail: signature, docs, methods, variants, optionally trait impls + examples |
 | `search_crate` | Ranked symbol search (exact > prefix > substring) with canonical paths |
 | `search_crates` | Search crates.io by keyword — returns name, description, downloads, version |
+| `get_crate_versions` | All published versions with dates and yanked status (crates.io API) |
+| `get_source_code` | Raw source code of a file from docs.rs or doc.rust-lang.org |
 
 Every tool accepts an optional `version` parameter to pin a specific crate version instead of `latest`.
 
@@ -371,6 +373,52 @@ Search for Rust crates on crates.io by keyword.
 
 ---
 
+### `get_crate_versions`
+
+List all published versions of a crate from crates.io.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `crateName` | string | yes | Crate name |
+
+```
+> get_crate_versions({ crateName: "serde" })
+
+# serde — 312 versions
+
+  1.0.219  2025-02-01
+  1.0.218  2025-01-12
+  1.0.217  2024-12-23
+  ...
+  0.1.0  2014-12-09
+```
+
+---
+
+### `get_source_code`
+
+Fetch the raw source code of a file from docs.rs (or doc.rust-lang.org for std crates).
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `crateName` | string | yes | Crate name |
+| `path` | string | yes | Source path relative to crate root (e.g. `"src/lib.rs"`, `"src/sync/mutex.rs"`) |
+| `version` | string | no | Pinned version |
+
+```
+> get_source_code({ crateName: "tokio", path: "src/sync/mutex.rs" })
+
+# Source: tokio/src/sync/mutex.rs
+https://docs.rs/tokio/latest/src/tokio/sync/mutex.rs
+
+\`\`\`rust
+use crate::sync::batch_semaphore as semaphore;
+...
+\`\`\`
+```
+
+---
+
 ## Recommended workflows
 
 ### Exploring a new crate
@@ -408,6 +456,8 @@ src/
     lookup-item.ts      lookup_crate_item
     search.ts           search_crate
     search-crates.ts    search_crates
+    crate-versions.ts   get_crate_versions
+    source-code.ts      get_source_code
     crate-metadata.ts   get_crate_metadata
     crate-brief.ts      get_crate_brief
 ```

package/dist/index.js

@@ -21,7 +21,7 @@ function cacheSet(key, data, ttl = DEFAULT_TTL) {
 }
 const DOCS_BASE = "https://docs.rs";
 const CRATES_IO = "https://crates.io/api/v1";
-const USER_AGENT = "mcp-rust-docs/3.0.0";
+const USER_AGENT = "mcp-rust-docs/3.1.0";
 const MAX_DOC_LENGTH = 6e3;
 const MAX_SEARCH_RESULTS = 100;
 const SECTION_TO_TYPE = {
@@ -209,7 +209,7 @@ const itemTypeEnum = z.enum([
   "derive"
 ]);
 const versionParam = z.string().optional().describe('Crate version (e.g. "1.49.0"). Defaults to latest.');
-function register$6(server2) {
+function register$8(server2) {
   server2.tool(
     "lookup_crate_docs",
     "Fetch the main documentation for a Rust crate. Returns overview, version, sections, and re-exports.",
@@ -246,7 +246,7 @@ function register$6(server2) {
     }
   );
 }
-function register$5(server2) {
+function register$7(server2) {
   server2.tool(
     "get_crate_items",
     "List public items in a crate root or module. Returns names, types, feature gates, and short descriptions.",
@@ -291,7 +291,7 @@ function register$5(server2) {
     }
   );
 }
-function register$4(server2) {
+function register$6(server2) {
   server2.tool(
     "lookup_crate_item",
     "Get detailed documentation for a specific item. Returns signature, docs, feature gate, methods, trait impls, and optionally examples.",
@@ -389,7 +389,7 @@ function scoreMatch(name, query) {
   if (lower.includes(q)) return 20;
   return 0;
 }
-function register$3(server2) {
+function register$5(server2) {
   server2.tool(
     "search_crate",
     "Search for items by name within a Rust crate. Returns ranked results with canonical paths and item types.",
@@ -433,7 +433,7 @@ function register$3(server2) {
     }
   );
 }
-function register$2(server2) {
+function register$4(server2) {
   server2.tool(
     "get_crate_metadata",
     "Get crate metadata from crates.io: version, features, default features, optional dependencies, and links.",
@@ -500,7 +500,7 @@ Use lookup_crate_docs, get_crate_items, lookup_crate_item, or search_crate to br
     }
   );
 }
-function register$1(server2) {
+function register$3(server2) {
   server2.tool(
     "get_crate_brief",
     "Bundle call: fetches crate metadata, overview docs, module list, re-exports, and optionally items from focused modules — all in one shot.",
@@ -610,7 +610,7 @@ function register$1(server2) {
     }
   );
 }
-function register(server2) {
+function register$2(server2) {
   server2.tool(
     "search_crates",
     "Search for Rust crates on crates.io by keyword. Returns name, description, downloads, and version.",
@@ -658,8 +658,108 @@ function register(server2) {
     }
   );
 }
+function register$1(server2) {
+  server2.tool(
+    "get_crate_versions",
+    "List all published versions of a crate from crates.io, with yanked status and release dates.",
+    {
+      crateName: z.string().describe("Crate name")
+    },
+    async ({ crateName }) => {
+      try {
+        if (isStdCrate(crateName)) {
+          return textResult(
+            `"${crateName}" is part of the Rust standard library and is not published on crates.io.
+Its version matches the Rust toolchain version.`
+          );
+        }
+        const cacheKey = `crate-versions:${crateName}`;
+        const cached = cacheGet(cacheKey);
+        if (cached) {
+          console.log(`[cache hit] crate-versions ${crateName}`);
+          return textResult(cached);
+        }
+        const { data } = await axios.get(`${CRATES_IO}/crates/${crateName}/versions`, {
+          headers: { "User-Agent": USER_AGENT },
+          timeout: 1e4
+        });
+        const versions = (data.versions ?? []).map((v) => ({
+          num: v.num,
+          yanked: v.yanked,
+          created_at: v.created_at,
+          license: v.license ?? ""
+        }));
+        if (!versions.length) {
+          return textResult(`No versions found for "${crateName}".`);
+        }
+        const lines = versions.map((v) => {
+          const date = v.created_at.slice(0, 10);
+          const yanked = v.yanked ? " [YANKED]" : "";
+          return `  ${v.num}  ${date}${yanked}`;
+        });
+        const result = [
+          `# ${crateName} — ${versions.length} versions`,
+          "",
+          ...lines
+        ].join("\n");
+        cacheSet(cacheKey, result);
+        return textResult(result);
+      } catch (e) {
+        return errorResult(`Could not fetch versions for "${crateName}". ${e.message}`);
+      }
+    }
+  );
+}
+function register(server2) {
+  server2.tool(
+    "get_source_code",
+    "Fetch the source code of a Rust item from docs.rs. Returns the raw source implementation.",
+    {
+      crateName: z.string().describe("Crate name"),
+      path: z.string().describe('Source path relative to crate root (e.g. "src/lib.rs", "src/sync/mutex.rs")'),
+      version: versionParam
+    },
+    async ({ crateName, path, version }) => {
+      try {
+        if (isStdCrate(crateName)) {
+          const url2 = `https://doc.rust-lang.org/stable/src/${crateName}/${path}`;
+          const $2 = await fetchDom(url2);
+          const code2 = $2("#source-code").text().trim() || $2("pre.rust").text().trim();
+          if (!code2) return errorResult(`No source code found at ${url2}`);
+          return textResult([
+            `# Source: ${crateName}/${path}`,
+            url2,
+            "",
+            "```rust",
+            truncate(code2, 12e3),
+            "```"
+          ].join("\n"));
+        }
+        const ver = version ?? "latest";
+        const url = `${DOCS_BASE}/${crateName}/${ver}/src/${crateSlug(crateName)}/${path}`;
+        const $ = await fetchDom(url);
+        const code = $("#source-code").text().trim() || $("pre.rust").text().trim() || $(".src-line-numbers + code").text().trim();
+        if (!code) {
+          return errorResult(`No source code found at ${url}. Check that the path is correct.`);
+        }
+        return textResult([
+          `# Source: ${crateName}/${path}`,
+          url,
+          "",
+          "```rust",
+          truncate(code, 12e3),
+          "```"
+        ].join("\n"));
+      } catch (e) {
+        return errorResult(`Could not fetch source for "${crateName}/${path}". ${e.message}`);
+      }
+    }
+  );
+}
 console.log = (...args) => console.error(...args);
-const server = new McpServer({ name: "rust-docs", version: "3.0.0" });
+const server = new McpServer({ name: "rust-docs", version: "3.1.0" });
+register$8(server);
+register$7(server);
 register$6(server);
 register$5(server);
 register$4(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-rustdoc",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "description": "MCP server for fetching and browsing Rust crate documentation from docs.rs and crates.io",
   "main": "dist/index.js",