How do I install the gnosis mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GNOSIS_MCP_DATABASE_URL`, `GNOSIS_MCP_API_KEY`, `GNOSIS_MCP_EMBED_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Gnosis MCP Server

<strong>Stop pasting files into context. Your AI agent searches your local docs instead. 5–10× fewer tokens per lookup. 92 % Hit@5 on real dev docs.

Remote serverstreamable-httpPython

What is the Gnosis MCP Server?

Stop pasting files into context. Your AI agent searches your local docs instead. 5–10× fewer tokens per lookup. 92 % Hit@5 on real dev docs. Zero cloud

What it actually does

Zero config — — SQLite by default, pip install and go
Hybrid search — — keyword (BM25) + semantic (local ONNX embeddings, no API key). Tune RRF fusion with GNOSIS_MCP_RRF_K
Cross-encoder reranking — — optional [reranking] extra with a 22M-param ONNX model. Off by default. Test on your own corpus before enabling — the bundled MS-MARCO reranker hurts dev-doc retrieval in our measurements
Git history — — ingest commit messages as searchable context (ingest-git)
Web crawl — — ingest documentation from any website via sitemap or link crawl
Multi-format — — .md .txt .ipynb .toml .csv .json + optional .rst .pdf

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
search_docs	Search by keyword or hybrid semantic+keyword
get_doc	Retrieve a full document by path
get_related	Find linked/related documents (multi-hop, relation type filtering)
search_git_history	Search indexed git commit history
get_context	Usage-weighted context summary
get_graph_stats	Knowledge graph topology: orphans, hubs, relation distribution
upsert_doc	Create or replace a document
delete_doc	Remove a document and its chunks
update_metadata	Change title, category, tags

How to install the Gnosis MCP Server

claude mcp add gnosis --env GNOSIS_MCP_DATABASE_URL=your-value --env GNOSIS_MCP_API_KEY=your-value --env GNOSIS_MCP_EMBED_API_KEY=your-value -- uvx gnosis-mcp

Configuration

Variable	Description	Required
GNOSIS_MCP_DATABASE_URL	Endpoint or connection string the server talks to.	Yes
GNOSIS_MCP_API_KEY	Credential the server authenticates with.	Yes
GNOSIS_MCP_EMBED_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Gnosis MCP to Endpoint.”
“Use Gnosis MCP to search docs.”
“Use Gnosis MCP to get doc.”

Frequently asked questions

<strong>Stop pasting files into context. Your AI agent searches your local docs instead. 5–10× fewer tokens per lookup. 92 % Hit@5 on real dev docs. Zero cloud Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.