Niivue MCP

🚀 @edziocodes/niivue-mcp

An MCP server that offers Niivue documentation and API reference to LLMs, featuring fast lexical search and optional semantic hybrid search.

🚀 Quick Start

This MCP server provides Niivue documentation and API reference to LLMs, with fast lexical search and the option of semantic hybrid search.

✨ Features

• Conduct full - text search across Niivue docs and guides (using BM25 + embeddings).
• Look up APIs from JSDoc comments in the Niivue TypeScript source.
• Utilize structured tools for overview, search, listing, and page retrieval.
• Benefit from a local cache to minimize startup and query latency.

📦 Installation

npm install @edziocodes/niivue-mcp

💻 Usage Examples

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

📚 Documentation

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

📄 License

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