SpecNavigator

You can use the MCP SpecNavigator server to explore, navigate, and stay up-to-date with the MCP specification. It dynamically builds navigation trees, lets you search for sections quickly, and can synchronize with upstream changes, making it easier to locate and retrieve exact parts of the MCP specification for your workflows.

How to use

Start the server and connect through an MCP client to access dynamic markdown trees, keyword search, and on-demand section content. Use the client to request a specific section path (for example, protocol/messages) and choose whether to include subsections. You can also trigger upstream checks to see if the latest specification changes are available and cache results for fast repeated access.

How to install

Prerequisites: you will need Node.js installed on your system. You may also want a package manager like npm or npx available on your PATH.

# Install the MCP SpecNavigator server globally (recommended for quick start)
npm install -g @lepion/mcp-server-specnavigator

Configuration and start options

Two common ways to run the server are provided for integration with clients like Claude Desktop or for development purposes. Use the block examples to configure your MCP client or editor to launch the server.

{
  "mcpServers": {
    "specnavigator_npx": {
      "command": "npx",
      "args": ["@lepion/mcp-server-specnavigator"],
      "env": {
        "NODE_ENV": "production"
      }
    },
    "specnavigator_node_dev": {
      "command": "node",
      "args": ["/path/to/mcp-server-specnavigator/dist/index.js"],
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

Notes on usage patterns

• Use the up-to-date upstream sync to keep your local copy aligned with the official MCP repository.
• Generate a searchable markdown tree to quickly locate sections by keyword.
• Retrieve exact section content with an option to include subsections.
• Leverage caching to minimize repeated network requests and improve response times.

Available tools

fetch_spec_updates

Check for upstream changes in the MCP specification repository, with an option to force refresh even if the cache is valid.

generate_markdown_tree

Create a navigable markdown tree from the MCP specification, with options for depth and including anchors.

find_section

Search for sections by keyword and return matching titles, paths, and anchor links, with optional fuzzy matching.

get_spec_content

Retrieve content from a specific section of the MCP specification, with an option to include subsections.