8000 GitHub - dcdpr/bookworm: MCP server for Rust documentation
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

dcdpr/bookworm

Repository files navigation

Bookworm

A collection of tools to work with docs.rs documentation.

Crates

wrm_dl

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/...

wrm_index

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

wrm_query

Query the documentation for a crate, using a locally stored version of the crate documentation, and the index database.

wrm_docs

Fetch details from locally cached docs.rs documentation.

wrm_mcp

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"
    }
  }
}

Tools

The following tools are available to an LLM with MCP client capabilities:

crates_search

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.

crate_search_items

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
crate_search_src (TODO)

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.

crate_resource

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 versions
  • crate://{crate_name}/{crate_version} - get metadata
  • crate://{crate_name}/{crate_version}/readme - get readme content
  • crate://{crate_name}/{crate_version}/items - list item resources
  • crate://{crate_name}/{crate_version}/src - list source code resources
  • crate://{crate_name}/{crate_version}/{path} - get item/src resource
crate://{crate_name} - list crate versions

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
crate://{crate_name}/{crate_version} - get crate metadata

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)
crate://{crate_name}/{crate_version}/readme - get crate readme

Returns the crate README as a string, formatted as Markdown.

crate://{crate_name}/{crate_version}/items - list crate items

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.

crate://{crate_name}/{crate_version}/src - list crate source code resources

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.

crate://{crate_name}/{crate_version}/{crate_resource_path} - get crate resource

Returns the content of the resource at the given path.

Url Templating
  • {crate_name} is the exact name of the crate.
  • {crate_version} is either a (partial) semver compatible version number, or latest for the latest published crate version.

About

MCP server for Rust documentation

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

0