dcdpr / jp / 25955866145

66%

push

github

chore(tools): Add `bookworm` MCP server for Rust crate docs (#644)

Introduce the `bookworm` contrib crate — an MCP server that gives the JP
development assistant grounded access to published Rust crate
documentation without relying on training-data memory.

The server exposes five tools over stdio:

- `crates_search` — keyword search on crates.io
- `crate_search_items` — partial-path search for types, fns, traits,
methods, variants, etc. inside a specific crate version
- `crate_resource` — single entry-point for all `crate://` URIs
(versions, metadata, README, item docs, source files)
- `crate_versions` — list recent non-yanked releases of a crate
- `crate_readme` — fetch and HTML-to-Markdown-convert a crate README

Documentation is fetched on demand from docs.rs, unzipped, sanitized,
and indexed into a per-crate SQLite database under the system temp dir.
Subsequent calls for the same crate+version hit the cache and skip the
network round-trip.

The server is wired into the JP development config as the `bookworm` MCP
provider, pointing at the `serve-bookworm` just recipe, which does an
incremental `cargo build --release` before spawning the binary. That
means every `jp query` session picks up the latest local source
automatically without a manual rebuild step.

Two new skill files are added:

- `.jp/config/skill/rust-docs.toml` — enables all five bookworm tools
and instructs the assistant to use them for third-party crates (while
continuing to use the `fs_*` tools for the JP workspace crates, which
are not published on crates.io).
- The existing `rust-development` skill now extends `rust-docs`, and the
`architect` persona also includes it directly.

Two workspace dependencies are added to `Cargo.toml`: `semver` (for
version string validation) and `zip` with the `bzip2` feature (for
extracting docs.rs download archives).

---------

Signed-off-by: Jean Mertz <git@jeanmertz.com>

403 of 1674 new or added lines in 16 files covered. (24.07%)

26719 of 41079 relevant lines covered (65.04%)

192.73 hits per line