Skip to content

v0.1.0 — one lens over code + markdown

Choose a tag to compare

View all tags
@segentic-lab segentic-lab released this 06 Jul 14:39
· 4 commits to main since this release
v0.1.0
93a88b4

First release of lens-mcp — the merge of codelens-mcp and docslens-mcp into one navigation-lens server. Sibling of periscope-mcp; same standard: honest errors, caps + truncated flags everywhere, docs == behavior.

Give the agent a map, not the territory — deterministic (real parsing, no model summarizing), so an agent spends context on thinking, not browsing files.

11 tools, one contract

Orientation

  • map — whole-project surface in ONE call: per code file → structure, per doc → outline. Both families, one response.
  • info — version, sandbox root, languages/extensions, caps, contract.

Code (tree-sitter: .ts .tsx .mts .cts .js .jsx .mjs .cjs .py)

  • overview, functions, function_body (one function's source — ~99% less context than the file), comments, find

Docs (markdown: .md .markdown .mdx)

  • outline, heading (one section by text/slug/line), links, search

Call the wrong family on a file and the error names the right tool. Syntax errors surface (hasErrors/parseErrors) instead of vanishing. Every list is capped with the true total.

The contract: lens is a navigation map — locate with it, then Read the real source/section before judging or modifying. A signature is not the body; an outline is not the section.

135 tests (unit + stdio e2e), CI on Node 18/20/22. Supersedes codelens-mcp 0.2.0 and the unreleased docslens-mcp. AGPL-3.0.

Assets 2
Loading