Scanner Mcp

scanner-mcp

An MCP server that scans C++ repositories and exposes 4 tools for AI agents

---

Features

• scan_files — list all files (path, extension, size) via lightweight filesystem walk
• scan_code — extract includes, classes, structs, functions, namespaces via tree-sitter AST
• getfileconnections — forward/reverse dependency graph between files
• getfilerankings — importance scoring by deps, symbols, and include frequency
• Shared cache — first call to any tool parses the repo; subsequent calls return instantly

Setup for agents

Clone and build (requires CMake ≥ 3.14 — install from https://cmake.org/download/):

git clone 
cd scanner-mcp
cmake -B build && cmake --build build

Then add to opencode.json:

{
  "mcp": {
    "scanner-mcp": {
      "type": "local",
      "command": ["/absolute/path/to/scanner-mcp/build/scanner-mcp"],
      "enabled": true
    }
  }
}

Tools

| Tool | Arguments | Returns | |---|---|---| | scan_files | path (req) | { files: [{ path, extension, size }] } | | scan_code | path (req), refresh | { code: [{ file, includes, classes, structs, functions, namespaces }] } | | get_file_connections | path (req), refresh | { file_connections: { forward, reverse } } | | get_file_rankings | path (req), refresh | { file_rankings: [{ path, score, incoming_deps, outgoing_deps, symbols, include_freq }] } |

scan_files walks the filesystem only — no parsing, no cache, always fast. scan_code, get_file_connections, and get_file_rankings share a cache keyed by absolute path. The first call parses the repo once; subsequent calls return instantly. Set refresh: true to bust the cache when files change.

Requirements

• CMake ≥ 3.14
• C++17 compiler (GCC 9+, Clang 10+, Apple Clang 14+)
• Linux (x86_64)

Architecture

FILE DISCOVERY      → walk, filter, metadata                   scan_files
CODE EXTRACTION      → includes, symbols via tree-sitter AST   scan_code
DEPENDENCY ANALYSIS  → forward/reverse connections             get_file_connections
IMPORTANCE RANKING   → scoring heuristics                      get_file_rankings

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: chrisipanaque
• Source: chrisipanaque/scanner-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.