kyrylopr avatar

Lenspr

kyrylopr/lenspr

Builds a dependency graph of your Python and TypeScript codebase so Claude can see what breaks before making changes. Exposes 60+ tools across navigation, impact analysis, architecture rules, and cross-language linking. lens_context returns source, callers, callees, and tests in one shot instead of seven grep calls. lens_check_impact shows blast radius with severity ratings. lens_vibecheck scores codebase health across test coverage, dead code, and circular imports. Connects frontend HTTP calls to backend routes, database tables, Docker services, and env vars in a single graph. Runs locally via Jedi, Pyright, and tree-sitter. Reach for this when you're tired of AI agents breaking dependencies three files away because they only see one file at a time.

tools
60
transport
STDIO
last updated
Feb 23, 2026

Tools

60 tools

Public tool metadata for what this MCP can expose to an agent.

lens_contextOne call returns source code, who calls it, what it calls, and related tests.

One call returns source code, who calls it, what it calls, and related tests.

No parameter schema in public metadata yet.

lens_check_impactBefore any modification, the AI sees the blast radius.

Before any modification, the AI sees the blast radius.

No parameter schema in public metadata yet.

lens_vibecheckHealth score across 6 dimensions, tracking whether the codebase is improving or degrading over time.

Health score across 6 dimensions, tracking whether the codebase is improving or degrading over time.

No parameter schema in public metadata yet.

lens_get_node

No parameter schema in public metadata yet.

lens_search

No parameter schema in public metadata yet.

lens_grep

No parameter schema in public metadata yet.

lens_find_usages

No parameter schema in public metadata yet.

lens_get_structure

No parameter schema in public metadata yet.

lens_list_nodes

No parameter schema in public metadata yet.

lens_get_connections

No parameter schema in public metadata yet.

lens_update_node

No parameter schema in public metadata yet.

lens_patch_node

No parameter schema in public metadata yet.

lens_add_node

No parameter schema in public metadata yet.

lens_delete_node

No parameter schema in public metadata yet.

lens_rename

No parameter schema in public metadata yet.

lens_batch

No parameter schema in public metadata yet.

lens_validate_change

No parameter schema in public metadata yet.

lens_health

No parameter schema in public metadata yet.

lens_dead_code

No parameter schema in public metadata yet.

lens_dependencies

No parameter schema in public metadata yet.

lens_diff

No parameter schema in public metadata yet.

lens_nfr_check

No parameter schema in public metadata yet.

lens_test_coverage

No parameter schema in public metadata yet.

lens_security_scan

No parameter schema in public metadata yet.

lens_dep_audit

No parameter schema in public metadata yet.

lens_fix_plan

No parameter schema in public metadata yet.

lens_generate_test_skeleton

No parameter schema in public metadata yet.

lens_arch_rule_add

No parameter schema in public metadata yet.

lens_arch_rule_list

No parameter schema in public metadata yet.

lens_arch_rule_delete

No parameter schema in public metadata yet.

lens_arch_check

No parameter schema in public metadata yet.

lens_class_metrics

No parameter schema in public metadata yet.

lens_project_metrics

No parameter schema in public metadata yet.

lens_largest_classes

No parameter schema in public metadata yet.

lens_compare_classes

No parameter schema in public metadata yet.

lens_components

No parameter schema in public metadata yet.

lens_blame

No parameter schema in public metadata yet.

lens_node_history

No parameter schema in public metadata yet.

lens_commit_scope

No parameter schema in public metadata yet.

lens_recent_changes

No parameter schema in public metadata yet.

lens_api_map

No parameter schema in public metadata yet.

lens_db_map

No parameter schema in public metadata yet.

lens_env_map

No parameter schema in public metadata yet.

lens_ffi_map

No parameter schema in public metadata yet.

lens_infra_map

No parameter schema in public metadata yet.

lens_run_tests

No parameter schema in public metadata yet.

lens_trace

No parameter schema in public metadata yet.

lens_trace_stats

No parameter schema in public metadata yet.

lens_annotate

No parameter schema in public metadata yet.

lens_save_annotation

No parameter schema in public metadata yet.

lens_batch_save_annotations

No parameter schema in public metadata yet.

lens_annotate_batch

No parameter schema in public metadata yet.

lens_annotation_stats

No parameter schema in public metadata yet.

lens_session_write

No parameter schema in public metadata yet.

lens_session_read

No parameter schema in public metadata yet.

lens_session_handoff

No parameter schema in public metadata yet.

lens_resume

No parameter schema in public metadata yet.

lens_hotspots

No parameter schema in public metadata yet.

lens_node_timeline

No parameter schema in public metadata yet.

lens_explain

No parameter schema in public metadata yet.

Sponsors

Readme

LensPR

Code intelligence for AI coding agents. Your AI sees dependencies before making changes.

Alpha (0.1.x) — works on real projects, used daily by the author. Expect rough edges.

AI assistants edit your code one file at a time. They don't see dependencies. They grep, read, guess — and break things three files away.

LensPR builds a dependency graph of your codebase and gives your AI structural understanding before it changes anything.

Quick Start

Requires Python 3.11+, macOS or Linux. For TypeScript/JS projects, also Node.js 18+.

pip install 'lenspr[all]'
lenspr init .
lenspr setup .

Restart your IDE. Done. Your AI now has lens_* tools.

Add .lens/ to your .gitignore — the graph is local and rebuilt from source.


What It Does

"What depends on this function?"

One call returns source code, who calls it, what it calls, and related tests:

> lens_context("auth.login_handler")

View the full README on GitHub

Details

Repository
github.com/kyrylopr/lenspr
Package
lenspr
Transport
STDIO
Registry
MCP registry, active