Knolo

Name: Knolo
Author: HiveForensics-AI

本地服务

github.com/HiveForensics-AI记忆与知识512 周前更新

代码仓库

关于 Knolo

Knolo 是面向本地安装并固定版本的 Knolo V5 Knowledge Images 的只读 MCP 服务。它提供经策略检查的检索并记录查询回执；镜像或策略哈希不匹配时，会在连接前拒绝启动。

主要功能

01搜索已固定的知识镜像
02获取镜像内容
03验证固定项与策略
04报告服务状态
05返回搜索结果前记录回执

适用场景

01通过 MCP 客户端搜索本地手册
02检查镜像固定项和策略状态
03为每次搜索保留审计回执

MCP 相关

它通过 stdio 暴露 knolo_search、knolo_get、knolo_verify 和 knolo_status 四个工具。不提供 MCP 资源或提示词。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hiveforensics-ai-knolo": {
      "command": "npx",
      "args": [
        "-y",
        "@knolo/mcp"
      ],
      "env": {
        "KNOLO_MCP_CONFIG": "<KNOLO_MCP_CONFIG>"
      }
    }
  }
}

启动命令npx -y @knolo/mcp

需要配置的环境变量

KNOLO_MCP_CONFIGAbsolute path to knolo-mcp config JSON

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@knolo/mcp0.1.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@knolo/mcp

@knolo/mcp 是一个只读的 MCP 服务，用于固定 Knolo V5 知识映像。它提供与 @knolo/openclaw 相同的四个工具：knolo_search、knolo_get、knolo_verify 和 knolo_status。固定项、策略检查和查询回执均来自 @knolo/tools。

该服务仅通过 stdio 通信。它不会下载映像、建立运行时网络连接、写入或编译知识，也不会公开 MCP 资源或提示词。启动前请安装并固定每个映像。若哈希、状态根目录或策略根目录不匹配，进程会在 MCP 连接启动前以非零状态退出。

调用方身份由配置文件中的 agentId 指定，默认为 mcp。该 ID 必须列在挂载项的 agents 数组中。工具参数无法设置该值。MCP 客户端的 clientInfo.name 会作为 sessionId 存入回执，但不会用于授权。策略评估时，每个挂载项只会使用一个 principal。

每次搜索都会在返回命中项前写入一条 openclaw-knolo-query-v1 回执。如果 auditDir 不可写，则会返回 AUDIT_UNAVAILABLE，且不返回任何命中项。要更改固定项，请重启进程。不支持热重载。

@knolo/[email protected] 尚未发布到 npm 或 MCP Registry。server.json 中的注册表名称为 io.github.HiveForensics-AI/knolo。

配置

路径必须是绝对路径。sha256 为 64 个小写十六进制字符。stateRoot 的格式为 sha256- 加上 64 个小写十六进制字符。

{
  "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>"
    }
  ]
}

使用 knolo-mcp --config /absolute/knolo-mcp.json 或 KNOLO_MCP_CONFIG 启动。日志输出到 stderr。Stdout 仅输出 JSON-RPC。

客户端

Claude Desktop、Claude Code 和 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"
      ]
    }
  }
}

该软件包要求 Node 20 或更高版本，以及 @knolo/core ^6.0.0。它不实现 KAR、覆盖率或组合功能。

支持 Markdown

登录后评论