mcpField
K
Knolo

Knolo

Local
github.com/HiveForensics-AIMemory & Knowledge51Updated 2w ago
Repository

About Knolo

Knolo is a read-only MCP server for locally installed, pinned Knolo V5 Knowledge Images. It provides policy-checked retrieval with query receipts and rejects mismatched image or policy hashes before connecting.

Key features

  1. 01Search pinned knowledge images
  2. 02Retrieve image content
  3. 03Verify pins and policy
  4. 04Report server status
  5. 05Record receipts before returning search results

Use cases

  1. 01Search a local handbook through an MCP client
  2. 02Check pinned image and policy state
  3. 03Keep an audit receipt for each search

MCP support

It exposes four tools—knolo_search, knolo_get, knolo_verify, and knolo_status—over stdio. It does not expose MCP resources or prompts.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hiveforensics-ai-knolo": {
      "command": "npx",
      "args": [
        "-y",
        "@knolo/mcp"
      ],
      "env": {
        "KNOLO_MCP_CONFIG": "<KNOLO_MCP_CONFIG>"
      }
    }
  }
}
Run commandnpx -y @knolo/mcp
Environment variables to set
KNOLO_MCP_CONFIGAbsolute path to knolo-mcp config JSON

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@knolo/mcp0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

@knolo/mcp

@knolo/mcp is a read-only MCP server for pinned Knolo V5 Knowledge Images. It exposes the same four tools as @knolo/openclaw: knolo_search, knolo_get, knolo_verify, and knolo_status. Pins, policy checks, and query receipts come from @knolo/tools.

The server speaks stdio only. It does not download images, open a runtime network connection, write or compile knowledge, or expose MCP resources or prompts. Install and pin each image before starting it. A hash, state-root, or policy-root mismatch exits non-zero before the MCP connection starts.

Caller identity is agentId in the config file, default mcp. That id must be listed in the mount's agents array. Tool arguments cannot set it. The MCP client's clientInfo.name is stored on the receipt as sessionId and is not used for authorization. One principal per mount is what policy evaluation sees.

Every search writes an openclaw-knolo-query-v1 receipt before it returns hits. An unwritable auditDir returns AUDIT_UNAVAILABLE and no hits. Restart the process to change pins. There is no hot reload.

@knolo/[email protected] is not published to npm or the MCP Registry yet. The registry name in server.json is io.github.HiveForensics-AI/knolo.

Config

Paths are absolute. sha256 is 64 lowercase hex characters. stateRoot is sha256- plus 64 lowercase hex characters.

{
  "agentId": "mcp",
  "auditDir": "/var/lib/knolo/receipts",
  "mounts": [
    {
      "id": "handbook",
      "path": "/opt/knolo/handbook.knolo",
      "sha256": "<64 hex>",
      "stateRoot": "sha256-<64 hex>",
      "policyPath": "/opt/knolo/handbook.policy.json",
      "agents": ["mcp"],
      "principal": "<policy principal>"
    }
  ]
}

Start it with knolo-mcp --config /absolute/knolo-mcp.json or KNOLO_MCP_CONFIG. Logs go to stderr. Stdout is JSON-RPC only.

Clients

Claude Desktop, Claude Code, and Cursor:

{
  "mcpServers": {
    "knolo": {
      "command": "npx",
      "args": ["-y", "@knolo/mcp", "--config", "/absolute/knolo-mcp.json"]
    }
  }
}

Claude Code CLI:

claude mcp add knolo -- npx -y @knolo/mcp --config /absolute/knolo-mcp.json

VS Code (.vscode/mcp.json):

{
  "servers": {
    "knolo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@knolo/mcp",
        "--config",
        "${workspaceFolder}/knolo-mcp.json"
      ]
    }
  }
}

The package requires Node 20 or newer and @knolo/core ^6.0.0. It does not implement KAR, coverage, or composition.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.