Incorrect doc path lead program goes fail.

[aaababaaz]

https://github.com/Govcraft/rust-docs-mcp-server/blob/c70a393f9276b7ba8bf9413cd8aa756d06bdccce/src/doc_loader.rs#L125C1-L127C51

$ env RUST_LOG=debug OPENAI_API_BASE=http://192.168.1.1:11434/v1 OPENAI_API_KEY=sk- /home/user/.cargo/bin/rustdocs_mcp_server chromadb
Target Spec: chromadb, Parsed Name: chromadb, Version Req: *, Features: None
Cache file path: "/home/user/.local/share/rustdocs-mcp-server/chromadb/_/no_features/embeddings.bin"
Cache file not found. Will generate.
Proceeding with documentation loading and embedding generation.
Loading documents for crate: chromadb (Version Req: *, Features: None)
Error: DocLoader(CargoLib(Could not find any subdirectory containing index.html within '/tmp/.tmpoxHzmI/doc'. Cargo doc might have failed or produced unexpected output.))

$ cd /tmp/.tmpoGsEkR

$ LC_ALL=C l
total 52K
drwxr-xr-x  6 user user  200 Apr 30 19:51 .
drwxrwxrwt 45 root  root  5.0K Apr 30 19:55 ..
-rw-r--r--  1 user user  373 Apr 30 19:46 .rustc_info.json
-rw-r--r--  1 user user  234 Apr 30 19:46 .rustdoc_fingerprint.json
-rw-r--r--  1 user user  39K Apr 30 19:46 Cargo.lock
-rw-r--r--  1 user user  168 Apr 30 19:46 Cargo.toml
drwxr-xr-x  7 user user  160 Apr 30 19:46 debug
drwxr-xr-x  2 user user   60 Apr 30 19:46 src
drwxr-xr-x  5 user user  160 Apr 30 19:51 target
drwxr-xr-x  4 user user  100 Apr 30 19:46 x86_64-unknown-linux-gnu

$ LC_ALL=C l x86_64-unknown-linux-gnu 
total 4.0K
drwxr-xr-x 4 user user 100 Apr 30 19:46 .
drwxr-xr-x 6 user user 200 Apr 30 19:51 ..
-rw-r--r-- 1 user user 177 Apr 30 19:46 CACHEDIR.TAG
drwxr-xr-x 7 user user 160 Apr 30 19:46 debug
drwxr-xr-x 2 user user  40 Apr 30 19:46 doc

[rrrodzilla]

The PR with the OPENAI_API_BASE feature was not pushed into a release. It is now in v1.3.1. Give that a try.

[aaababaaz]

The PR with the OPENAI_API_BASE feature was not pushed into a release. It is now in v1.3.1. Give that a try.

I were using master git branch to compile by cargo install --git https://github.com/Govcraft/rust-docs-mcp-server.git

$ env RUST_LOG=debug OPENAI_API_BASE=http://192.168.1.1:11434/v1 OPENAI_API_KEY=sk- EMBEDDING_MODEL=huggingface.co/tensorblock/gte-Qwen2-7B-instruct-GGUF:Q6_K  /home/user/.cargo/bin/rustdocs_mcp_server rsa 
Target Spec: rsa, Parsed Name: rsa, Version Req: *, Features: None
Cache file path: "/home/user/.local/share/rustdocs-mcp-server/rsa/_/no_features/embeddings.bin"
Cache file not found. Will generate.
Proceeding with documentation loading and embedding generation.
Loading documents for crate: rsa (Version Req: *, Features: None)
Error: DocLoader(CargoLib(Could not find any subdirectory containing index.html within '/tmp/.tmpAqKkoD/doc'. Cargo doc might have failed or produced unexpected output.))

Anyway, I am no interested on this crate now, because somehow Roo Code can't see tools list of rust-docs-mcp-server.

As i point out the problem before https://github.com/Govcraft/rust-docs-mcp-server/blob/c70a393f9276b7ba8bf9413cd8aa756d06bdccce/src/doc_loader.rs#L125C1-L127C51

$ cat ~/.cargo/config.toml | grep -v -E "#"       

[cargo-new]
name = "@"
email = "@"

[target]

[target.x86_64-unknown-linux-musl]
linker = "ld.lld"
rustflags = ["-C", "target-feature=+crt-static", "-C", "linker=ld.lld", "-Z", "threads=16"]

[target.x86_64-unknown-linux-gnux32]
rustflags = [
    "-C", "link-arg=-fuse-ld=lld",
]

[build]
rustflags = ["--cfg", "tokio_unstable", "-Z", "threads=16"]

[profile.release]
codegen-units = 1
debug = false
lto = true
incremental = true
opt-level = 3
overflow-checks = false
panic = "abort"

[rrrodzilla]

Strange. Thanks for the feedback. I'll have to investigate. FWIW I was able to use it on Roocode so I'll have to dig deeper:

[234ms][~/Documents/Projects/virtual-staging/app]$ rustdocs_mcp_server rsa
Target Spec: rsa, Parsed Name: rsa, Version Req: *, Features: None
Cache file path: "/home/rodzilla/.local/share/rustdocs-mcp-server/rsa/_/no_features/embeddings.bin"
Cache file not found. Will generate.
Proceeding with documentation loading and embedding generation.
Loading documents for crate: rsa (Version Req: *, Features: None)
Using documentation path: /tmp/.tmptGvHZ4/doc/rsa
[DEBUG] Found 61 total HTML files initially.
[DEBUG] Filtered down to 28 files to process.
Finished document loading. Found 28 final documents.
Loaded 28 documents.
Generating embeddings...
Finished generating embeddings. Successfully processed 27 documents (37574 tokens).
Embedding generation cost for 37574 tokens: $0.000751
Saving generated documents and embeddings to: "/home/rodzilla/.local/share/rustdocs-mcp-server/rsa/_/no_features/embeddings.bin"
Warning: Embedding not found for document path: struct.BigUint.html. Skipping from cache.
Cache saved successfully (27 items).
Initializing server for crate: rsa (Version Req: *, Features: None)
Rust Docs MCP server starting via stdio...

[juanqui]

FWIW I am having the same issue reported by @aaababaaz.

> rustdocs_mcp_server rp2040-hal@0.11.0
Target Spec: rp2040-hal@0.11.0, Parsed Name: rp2040-hal, Version Req: 0.11.0, Features: None
Cache file path: "/Users/juanqui/.local/share/rustdocs-mcp-server/rp2040-hal/0.11.0/no_features/embeddings.bin"
Cache file not found. Will generate.
Proceeding with documentation loading and embedding generation.
Loading documents for crate: rp2040-hal (Version Req: 0.11.0, Features: None)
Error: DocLoader(CargoLib(Could not find any subdirectory containing index.html within '/var/folders/72/zy41y9ws5bscfks7ypzzqf0w0000gn/T/.tmpgTBjDR/doc'. Cargo doc might have failed or produced unexpected output.))

I'm running this inside an embedded project workspace configured with the thumbv6m-none-eabi target. This is my config.toml:

[target.'cfg(all(target_arch = "arm", target_os = "none"))']
runner = "probe-rs run --chip RP2040"

[build]
target = "thumbv6m-none-eabi"        # Cortex-M0 and Cortex-M0+

[env]
DEFMT_LOG = "debug"

If I run the exact same command outside of my embedded workspace, it actually works.

> rustdocs_mcp_server rp2040-hal@0.11.0
Target Spec: rp2040-hal@0.11.0, Parsed Name: rp2040-hal, Version Req: 0.11.0, Features: None
Cache file path: "/Users/juanqui/.local/share/rustdocs-mcp-server/rp2040-hal/0.11.0/no_features/embeddings.bin"
Cache file not found. Will generate.
Proceeding with documentation loading and embedding generation.
Loading documents for crate: rp2040-hal (Version Req: 0.11.0, Features: None)
Using documentation path: /var/folders/72/zy41y9ws5bscfks7ypzzqf0w0000gn/T/.tmpcvI71Q/doc/rp2040_hal
[DEBUG] Found 833 total HTML files initially.
[DEBUG] Filtered down to 486 files to process.
Finished document loading. Found 485 final documents.
Loaded 485 documents.
Generating embeddings...
Finished generating embeddings. Successfully processed 483 documents (421470 tokens).
Embedding generation cost for 421470 tokens: $0.008429
Saving generated documents and embeddings to: "/Users/juanqui/.local/share/rustdocs-mcp-server/rp2040-hal/0.11.0/no_features/embeddings.bin"
Warning: Embedding not found for document path: i2c/struct.I2C.html. Skipping from cache.
Warning: Embedding not found for document path: spi/struct.Spi.html. Skipping from cache.
Cache saved successfully (483 items).
Initializing server for crate: rp2040-hal (Version Req: 0.11.0, Features: None)
Rust Docs MCP server starting via stdio...

[rrrodzilla]

Thanks for that context. I'll look into it. In the meantime if you were able to generate the embedding file outside of the workspace then you should be able to copy the embeddings.bin file to the same location in your workspace to make it work. It sounds like its failing on the generation, but once you copy the bin over it should just use the existing bin from
/Users/juanqui/.local/share/rustdocs-mcp-server/rp2040-hal/0.11.0/no_features/embeddings.bin

[juanqui]

This unfortunately does not really work. I had already tried this, but the issue is that it's the platform/arch that is causing this to not work and most of the crates like esp-hal, rp2040-hal, etc do not work/compile on archs like stable-aarch64-apple-darwin, meaning I'm trading one error for another.