Niivue

npm version

MCP server that provides Niivue documentation and API reference to LLMs with fast lexical search and optional semantic hybrid search.

What you get

• Full text search over Niivue docs and guides (BM25 + embeddings).
• API lookup from JSDoc comments in the Niivue TypeScript source.
• Structured tools for overview, search, listing, and page retrieval.
• Local cache to keep startup and query latency low.

Installation

npm install @edziocodes/niivue-mcp

MCP Client Configuration

Add the following to your MCP client configuration (e.g., Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "niivue": {
      "command": "npx",
      "args": ["-y", "@edziocodes/niivue-mcp"]
    }
  }
}

Development

Clone and build from source:

git clone https://github.com/gaiborjosue/niivue-mcp.git
cd niivue-mcp
npm install
npm run build

Run locally:

npm run dev

Embeddings (hybrid search)

Hybrid search with semantic embeddings is enabled by default. The embedding model is downloaded on first use.

To disable embeddings and use BM25 search only:

npx @edziocodes/niivue-mcp --no-embeddings

Tools

• get_niivue_overview
• search_niivue_docs
• get_niivue_doc
• list_niivue_docs
• search_niivue_api
• get_niivue_api

Cache

Stored in ~/.niivue-mcp:

• docs/ raw markdown
• index.json BM25 index
• vectors.json vector index (when embeddings enabled)
• api-index.json parsed API entries
• meta.json cache metadata

Attribution

Docs and source are fetched from the Niivue repository: https://github.com/niivue/niivue/