mcp-nav-shared
Shared helpers for the codenav-mcp
and webnav-mcp MCP servers. This
package is not an MCP server itself. It's installed automatically as a
dependency of both servers, so you don't need to install it yourself.
The API follows the servers' needs and may change between minor versions; the servers pin a compatible range.
What it provides
| Module | Role |
|---|---|
mcp_nav_shared.lsp_client |
Async JSON-RPC/LSP subprocess client (LspClient): framing, request dispatch, document sync, file-change refresh, scratch documents, overlay() (show the server unsaved text to type-check an edit before writing it), rename / code-action / signature-help calls |
mcp_nav_shared.resolve |
Name-based symbol resolution (resolve_symbol, dotted Class.method, ambiguity errors) |
mcp_nav_shared.format |
Location headers (path:line:col), snippets, compact references, diagnostics and outline lists |
mcp_nav_shared.workspace |
Workspace-root selection (WorkspaceSelector: env pin, client MCP roots in the same git repository, CLAUDE_PROJECT_DIR, working directory) |
mcp_nav_shared.errors |
Tool-facing error text (missing file, timeout, LSP errors, …) |
mcp_nav_shared.params |
name/query parameter aliases with a helpful hint when both are missing |
mcp_nav_shared.notices |
Notices appended to tool results (e.g. a config change restarted the language server, or the server's own code changed since it started) |
mcp_nav_shared.edits |
Write-side primitives: LSP TextEdit/WorkspaceEdit application (UTF-16 columns, CRLF, BOM), whole-file FileChanges, diffs, EditPlan |
mcp_nav_shared.transaction |
WriteGuard (workspace/path/read-only rules), EditJournal (stale check, atomic apply with rollback, undo), PlanStore for previews |
mcp_nav_shared.diagnostics_delta |
Before/after diagnostics comparison keyed on message + source line, so shifted lines don't look like new errors |
mcp_nav_shared.exclude |
Directory names every scan skips (.git, node_modules, .venv, …) |
Development
Source: github.com/illescasDaniel/mcp-nav-shared. Design notes: docs/agent-tooling.md.
License
MIT. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for mcp-nav-shared 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_nav_shared-0.2.0.tar.gz | 37.9 kB | Without provenance | Details for mcp_nav_shared-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_nav_shared-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for mcp_nav_shared-0.2.0-py3-none-any.whl |
Total release size: 81.5 kB
Security for mcp-nav-shared 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
