@edziocodes/niivue-mcp
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_overviewsearch_niivue_docsget_niivue_doclist_niivue_docssearch_niivue_apiget_niivue_api
Cache
Stored in ~/.niivue-mcp:
docs/raw markdownindex.jsonBM25 indexvectors.jsonvector index (when embeddings enabled)api-index.jsonparsed API entriesmeta.jsoncache metadata
Attribution
Docs and source are fetched from the Niivue repository: https://github.com/niivue/niivue/