rustdoc-mcp 0.6.4

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
43
44
45
46

use super::*;

/// Format source code
pub(crate) fn format_source_code(request: &Request<'_>, span: &Span) -> String {
    // Resolve the file path - if it's relative, make it relative to the project root
    let file_path = if span.filename.is_absolute() {
        span.filename.clone()
    } else if let Some(project_root) = request.navigator().project_root() {
        project_root.join(&span.filename)
    } else {
        return String::new();
    };

    let Ok(file_content) = fs::read_to_string(&file_path) else {
        return String::new();
    };

    let lines: Vec<&str> = file_content.lines().collect();

    // rustdoc spans are 1-indexed
    let start_line = span.begin.0.saturating_sub(1);
    let end_line = span.end.0.saturating_sub(1);

    if start_line >= lines.len() {
        return String::new();
    }

    let end_line = end_line.min(lines.len().saturating_sub(1));

    // Add a few lines of context around the item
    let context_lines = if end_line - start_line < 10 { 1 } else { 3 };
    let context_start = start_line.saturating_sub(context_lines);
    let context_end = (end_line + context_lines).min(lines.len().saturating_sub(1));

    let mut result = String::new();
    result.write_fmt(format_args!("\nSource: {}\n", file_path.display()));
    result.push_str("```rust\n");

    for line in lines[context_start..=context_end].iter() {
        result.write_fmt(format_args!("{line}\n"));
    }

    result.push_str("```\n");

    result
}