Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NiiVue MCP Serverhow do I load a NIfTI image in Niivue?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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
MCP Client Configuration
Add the following to your MCP client configuration (e.g., Claude Desktop, Cursor, etc.):
Development
Clone and build from source:
Run locally:
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:
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/