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 |
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.exclude |
Directory names every scan skips (.git, node_modules, .venv, …) |
Development
Developed in the SpaceMaker
repository as a uv workspace member (mcp-servers/mcp-nav-shared). Design
notes: docs/agent-tooling.md.
License
MIT. See LICENSE.
1 maintainer
Release files for mcp-nav-shared 0.1.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 | |
|---|---|---|---|
| mcp_nav_shared-0.1.0.tar.gz | 27.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_nav_shared-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 60.0 kB
