MCP Repo Mapper
This is the structure scanner for codebases that don't come with a map. It exposes scan_repo, find_circular_deps, language_breakdown, detect_framework, and find_entry_points as tools, plus a cached repo-structure resource. The Python dependency graph is built from AST parsing, framework detection looks for FastAPI, Flask, Django, Express, and Spring markers, and entry point ranking surfaces mains, app definitions, and Dockerfiles. It's deterministic and doesn't call an LLM or run your code. Designed as the first layer in a three server onboarding stack with mcp-ast-explorer and mcp-test-runner, feeding architecture mapping before you dive into symbols or tests.
- tools
- 5
- transport
- STDIO
- last updated
- May 25, 2026
Tools
5 toolsPublic tool metadata for what this MCP can expose to an agent.
scan_repoReturns a typed repo scan with files, language breakdown, entry points, Python dependency graph, and detected frameworks.
Returns a typed repo scan with files, language breakdown, entry points, Python dependency graph, and detected frameworks.
No parameter schema in public metadata yet.
find_circular_depsReturns circular dependencies from the static dependency graph.
Returns circular dependencies from the static dependency graph.
No parameter schema in public metadata yet.
language_breakdownReturns language counts by file count and bytes.
Returns language counts by file count and bytes.
No parameter schema in public metadata yet.
detect_frameworkDetects FastAPI, Flask, Django, Express, and Spring using registry-based markers.
Detects FastAPI, Flask, Django, Express, and Spring using registry-based markers.
No parameter schema in public metadata yet.
find_entry_pointsReturns ranked entry point candidates such as Python mains, FastAPI apps, package start scripts, Dockerfiles, and Node indexes.
Returns ranked entry point candidates such as Python mains, FastAPI apps, package start scripts, Dockerfiles, and Node indexes.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
mcp-repo-mapper
mcp-repo-mapper is a FastMCP server for deterministic repository structure mapping. It scans a local codebase and exposes file structure, language counts, Python import dependencies, circular dependency detection, framework detection, entry point candidates, and a cached repo structure resource.
The server does not call an LLM and does not execute user code. It is intended as a grounded structure tool for codebase onboarding agents such as wayfinder.
Codebase Onboarding Stack
mcp-repo-mapper is the structure layer in a three-server MCP tool stack for Project 6 wayfinder, a codebase onboarding agent.
Details
- Repository
- github.com/lovranran/mcp-repo-mapper
- Package
mcp-repo-mapper- Transport
- STDIO
- Registry
- MCP registry, active