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

//! Symbol resolution functionality for finding symbols in C++ codebases
//!
//! This module provides LSP-based symbol resolution capabilities that work with
//! clangd to find and identify symbols based on user queries, handling ambiguous
//! matches and providing the best candidate symbol for analysis.

use crate::clangd::session::ClangdSessionTrait;
use tracing::debug;

use crate::lsp::traits::LspClientTrait;
use crate::mcp_server::tools::analyze_symbols::AnalyzerError;
use crate::project::component_session::ComponentSession;
use crate::symbol::Symbol;

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

/// Get the first (best) matching symbol from the session based on the user query
pub async fn get_matching_symbol(
    symbol_query: &str,
    component_session: &ComponentSession,
) -> Result<Symbol, AnalyzerError> {
    // Use the LSP client to find symbols matching the provided name
    let mut session = component_session.lsp_session().await;
    let symbols = session
        .client_mut()
        .workspace_symbols(symbol_query.to_string())
        .await
        .map_err(AnalyzerError::from)?;

    if symbols.is_empty() {
        return Err(AnalyzerError::NoSymbols(symbol_query.to_string()));
    }

    debug!(
        "Found {} symbols matching '{}'",
        symbols.len(),
        symbol_query
    );

    // Convert to our Symbol type and return the first as the best match
    Ok(symbols[0].clone().into())
}