Server data from the Official MCP Registry
Deterministic repository structure mapping for onboarding agents.
Deterministic repository structure mapping for onboarding agents.
This is a well-structured MCP server for static repository analysis with no authentication requirements (appropriate for its use case as a grounded code inspection tool). The codebase demonstrates good security practices: no hardcoded credentials, no network calls, no code execution, proper input validation via Pydantic models, and comprehensive test coverage. Permissions are appropriately scoped to filesystem read operations. Minor findings around exception handling and resource cleanup do not materially impact security. Supply chain analysis found 6 known vulnerabilities in dependencies (1 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-lovranran-mcp-repo-mapper": {
"args": [
"mcp-repo-mapper"
],
"command": "uvx"
}
}
}From the project's GitHub README.
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.
mcp-repo-mapper is the structure layer in a three-server MCP tool stack for Project 6 wayfinder, a codebase onboarding agent.
mcp-repo-mapper maps repository structure, languages, entry points, framework evidence, and Python dependency edges.mcp-ast-explorer provides symbol-grounded Python definition, signature, reference, call-chain, and class-hierarchy lookups.mcp-test-runner runs local pytest/Jest checks and coverage summaries so agent claims can be verified against execution.In wayfinder, this server feeds the architecture-mapping step before semantic explanation or test verification begins.
scan_repo(path) returns a typed repo scan with files, language breakdown, entry points, Python dependency graph, and detected frameworks.find_circular_deps(path) returns circular dependencies from the static dependency graph.language_breakdown(path) returns language counts by file count and bytes.detect_framework(path) detects FastAPI, Flask, Django, Express, and Spring using registry-based markers.find_entry_points(path) returns ranked entry point candidates such as Python mains, FastAPI apps, package start scripts, Dockerfiles, and Node indexes.repo-structure://{url_hash} returns a cached JSON scan result after a tool call has populated the cache.uv sync --extra dev
Run the server locally:
uv run mcp-repo-mapper
uv run ruff check .
uv run mypy
uv run pytest
Resource reads use a cache populated by tool calls:
scan_repo(path) or another scan-backed tool.repo-structure://{url_hash}.The public resource uses repo-structure://... because URL schemes cannot contain underscores.
ast parsing.MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally