A collection of tools to work with docs.rs documentation.
Download the documentation for a crate from docs.rs and store it in a local directory.
It comes both as a library and a binary, you can run it locally using:
cargo run --bin wrm-dl --features cli -- regex
Documentation downloaded successfully to /tmp/...
Index locally stored crate documentation into a SQLite database.
It comes both as a library and a binary, you can run it locally using:
cargo run --bin wrm-index --features cli -- /tmp/...
Documentation indexed successfully to ./index.sqlite
Query the documentation for a crate, using a locally stored version of the crate documentation, and the index database.
Fetch details from locally cached docs.rs documentation.
A model context protocol server to serve the documentation for a crate.
Run it locally using:
cargo run --bin wrm-mcp
Adding the server to your MCP client depends on the client, but the following example works for Claude.ai:
{
"mcpServers": {
"bookworm": {
"command": "/path/to/wrm-mcp"
}
}
}
The following tools are available to an LLM with MCP client capabilities:
Get a list of crates matching the given query.
The returned list contains a list of URIs for each crate to fetch additional crate information.
Get a list of items matching the given query.
Each item type contains the following information:
- Item Path (e.g.
serde_json::value::Value
) - Item Type (e.g.
enum
) - Type Signature
- Documentation
- Related Resource URIs
Search all the crate's source code for a given query.
Each item contains the URI of the source code file, the line number, and the contents of the matched line, including any optional context surrounding the match.
Once you find a crate (or know the crate name), you can fetch relevant resources
through the crate_resource
tool. This tool takes a URI to the resource.
The following URIs are supported:
crate://{crate_name}
- list crate versionscrate://{crate_name}/{crate_version}
- get metadatacrate://{crate_name}/{crate_version}/readme
- get readme contentcrate://{crate_name}/{crate_version}/items
- list item resourcescrate://{crate_name}/{crate_version}/src
- list source code resourcescrate://{crate_name}/{crate_version}/{path}
- get item/src resource
Returns a list of crate versions for the given crate name.
Each item in the list contains the following information:
- Version
- Release Date
- MSRV
- Downloads
- Publisher
The following metadata is returned:
- Name
- Version
- Release Date
- Description
- Homepage
- Repository
- License
- URIs:
- Readme (e.g.
crate://serde_json/1.0.85/readme
) - Crate Item (e.g.
crate://serde_json/1.0.85/items
) - Source code (e.g.
crate://serde_json/1.0.85/src
)
- Readme (e.g.
Returns the crate README as a string, formatted as Markdown.
Returns a list of items for the given crate version.
An item is a component of a crate. There are several kinds of items:
- Modules
- Function definitions
- Type definitions
- Struct definitions
- Enumeration definitions
- Trait definitions
- Implementations
Use search_crate_items
to search for specific items.
Returns a list of source code resources for the given crate version.
For Example:
<Resources>
<Resource uri="crate://serde_json/1.0.85/src/serde_json/lib.rs" />
<Resource uri="crate://serde_json/1.0.85/src/serde_json/value.rs" />
<Resource uri="crate://serde_json/1.0.85/src/serde_json/map.rs" />
<Resource uri="crate://serde_json/1.0.85/src/serde_json/value/mod.rs" />
...
</Resources>
Use search_crate_src
to search all the crate's source code.
Returns the content of the resource at the given path.
{crate_name}
is the exact name of the crate.{crate_version}
is either a (partial) semver compatible version number, orlatest
for the latest published crate version.