v0.2.1

Improved AI agent guidance and error handling for C++ codebase navigation.

AI Agent Workflow Guidance

Tools now guide agents to call get_project_details first for absolute build
directory paths, then use those paths with search_symbols and analyze_symbol_context.
Eliminates relative vs absolute path confusion and concatenation errors.

Search tools distinguish C++ symbol names from file paths in query parameters.
Empty query exploration recommended for unfamiliar codebases.

Enhanced Error Messages

Path resolution errors now include scan root directory, available build directories,
and path resolution details. Errors guide agents toward correct usage instead of
providing cryptic failures.

Tool Performance Documentation

Documentation emphasizes semantic-aware tools outperform filesystem operations
(find, grep, cat) with C++ syntax understanding, template awareness, and
automatic project boundary detection.

---

🔍 What's Tested

• ✅ All unit tests passed
• ✅ Code formatting and linting checks
• ✅ Comprehensive E2E integration tests
• ✅ C++ test project compatibility
• ✅ TypeScript tooling compatibility
• ✅ Security audit passed

📦 Installation Options

From crates.io

cargo install mcp-cpp-server

Download Binary

Choose the appropriate binary for your platform:

• Linux x86_64: mcp-cpp-server-linux-x86_64
• Linux ARM64: mcp-cpp-server-linux-aarch64
• macOS x86_64: mcp-cpp-server-macos-x86_64
• macOS ARM64: mcp-cpp-server-macos-aarch64

🚀 Usage

See the README for detailed usage instructions.

🛠️ CLI Tool

Use the Python CLI tool for easy interaction:

python3 tools/mcp-cli.py --help