# Knolo

A read-only retrieval MCP server for pinned Knolo V5 Knowledge Images. It allows coding agents to query pre-verified local knowledge without network access.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 51
- Author: HiveForensics-AI
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HiveForensics-AI/knolo-core/tree/HEAD/packages/mcp
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/mcp/knolo

## What it does

The server functions strictly over stdio channels in read-only mode. It supplies four specific tools: `knolo_search`, `knolo_get`, `knolo_verify`, and `knolo_status`. Runtime internet access is disabled entirely. The process neither fetches remote data nor compiles assets, focusing solely on mounted knowledge archives.

Prior to launching, knowledge bundles must be mounted and pinned inside a JSON configuration. A mismatch between calculated and declared hashes for `sha256`, `stateRoot`, or policy files forces the process to exit immediately. Live reloading does not exist here. Any modification to mounts requires a full server restart.

Every search operation logs an `openclaw-knolo-query-v1` receipt to disk before returning results. If the target `auditDir` rejects write permissions, retrieval fails with an `AUDIT_UNAVAILABLE` code. Running this package requires Node 20 or higher alongside `@knolo/core` `^6.0.0`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KNOLO_MCP_CONFIG` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add knolo -e KNOLO_MCP_CONFIG=<KNOLO_MCP_CONFIG> -- npx -y @knolo/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env KNOLO_MCP_CONFIG=<KNOLO_MCP_CONFIG> -- npx -y @knolo/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@knolo/mcp"
            ],
            "env": {
                "KNOLO_MCP_CONFIG": "<KNOLO_MCP_CONFIG>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@knolo/mcp"
            ],
            "env": {
                "KNOLO_MCP_CONFIG": "<KNOLO_MCP_CONFIG>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KNOLO_MCP_CONFIG=<KNOLO_MCP_CONFIG> mcp npx -y @knolo/mcp
```
Replace <…> with your own values

## When to use it
- retrieve records from cryptographically pinned Knolo V5 images
- verify the integrity and health of mounted local archives
- audit agent queries using persistent disk receipts
- enforce agent identifier policies across mounted data

## Example prompts
- Search the handbook knowledge image for onboarding rules using `knolo_search`
- Verify the current state and health of mounted archives with `knolo_status`
- Fetch a specific document entry by its identifier via `knolo_get`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md