rustdoc-mcp 0.6.5

mcp server for rustdocs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

use ferritin_common::sources::{DocsRsSource, LocalSource, StdSource};
use ferritin_common::{Navigator, Resolver};
use std::ops::{Deref, DerefMut};
use std::path::PathBuf;

/// MCP-specific wrapper around a [`Resolver`] that adds formatting capabilities.
///
/// Lifetime `'a` is the [`Navigator`]'s lifetime — both the resolver and any
/// [`ferritin_common::DocRef`] it returns borrow from there.
pub(crate) struct Request<'a> {
    resolver: Resolver<'a>,
}

impl<'a> Deref for Request<'a> {
    type Target = Resolver<'a>;

    fn deref(&self) -> &Self::Target {
        &self.resolver
    }
}

impl<'a> DerefMut for Request<'a> {
    fn deref_mut(&mut self) -> &mut Self::Target {
        &mut self.resolver
    }
}

impl<'a> Request<'a> {
    pub(crate) fn new(navigator: &'a Navigator) -> Self {
        Self {
            resolver: Resolver::new(navigator),
        }
    }
}

/// Build a [`Navigator`] configured with all sources for the given manifest path.
pub(crate) fn build_navigator(manifest_path: PathBuf) -> Navigator {
    Navigator::default()
        .with_std_source(StdSource::from_rustup())
        .with_local_source(LocalSource::load(&manifest_path).ok())
        .with_docsrs_source(DocsRsSource::from_default_cache())
}