mcp-cpp-server 0.2.2

A high-performance Model Context Protocol (MCP) server for C++ code analysis using clangd LSP integration
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
47
48
49
50
51
52
53
54
55
56
57
58
59

//! Hover documentation analysis functionality for C++ symbols
//!
//! This module provides LSP-based hover documentation analysis capabilities
//! that work with clangd to extract rich documentation, type information,
//! and signatures for symbols, supporting both markdown and plain text formats.

use crate::clangd::session::ClangdSessionTrait;
use crate::lsp::traits::LspClientTrait;
use crate::mcp_server::tools::analyze_symbols::AnalyzerError;
use crate::project::component_session::ComponentSession;
use crate::symbol::FileLocation;

// ============================================================================
// Public API
// ============================================================================

/// Get hover information for a symbol
pub async fn get_hover_info(
    symbol_location: &FileLocation,
    component_session: &ComponentSession,
) -> Result<String, AnalyzerError> {
    let uri = symbol_location.get_uri();
    let lsp_position: lsp_types::Position = symbol_location.range.start.into();

    // Ensure file is ready first
    component_session
        .ensure_file_ready(&symbol_location.file_path)
        .await?;

    // Get LSP session and make the request
    let mut session = component_session.lsp_session().await;
    let client = session.client_mut();
    let hover_info = client
        .text_document_hover(uri, lsp_position)
        .await
        .map_err(AnalyzerError::from)?;

    let markup = match hover_info {
        Some(lsp_types::Hover {
            contents: lsp_types::HoverContents::Markup(markup),
            ..
        }) => Some(markup),
        _ => None,
    };

    match markup {
        Some(lsp_types::MarkupContent {
            kind: lsp_types::MarkupKind::Markdown,
            value,
        }) => Ok(value),
        Some(lsp_types::MarkupContent {
            kind: lsp_types::MarkupKind::PlainText,
            value,
        }) => Ok(value),
        _ => Err(AnalyzerError::NoData(
            "No hover content available".to_string(),
        )),
    }
}