Knolo

@knolo/mcp

@knolo/mcp は、ピン留めされた Knolo V5 Knowledge Images 用の読み取り専用 MCP サーバーです。 @knolo/openclaw と同じ 4 つのツール、knolo_search、knolo_get、knolo_verify、knolo_status を公開します。 ピン、ポリシーチェック、クエリレシートは @knolo/tools から取得します。

このサーバーは stdio のみで通信します。イメージのダウンロード、実行時のネットワーク接続、ナレッジの書き込みやコンパイルは行わず、MCP リソースやプロンプトも公開しません。起動前に各イメージをインストールしてピン留めしてください。ハッシュ、state-root、または policy-root が一致しない場合、MCP 接続の開始前にゼロ以外の終了コードで終了します。

呼び出し元の ID は設定ファイル内の agentId で、既定値は mcp です。この ID は、マウントの agents 配列に記載されている必要があります。ツールの引数でこの ID を設定することはできません。MCP クライアントの clientInfo.name はレシートに sessionId として保存され、認可には使用されません。ポリシー評価で認識される principal は、マウントごとに 1 つです。

検索のたびに、結果を返す前に openclaw-knolo-query-v1 レシートを書き込みます。書き込み可能な auditDir がない場合は AUDIT_UNAVAILABLE を返し、検索結果は返しません。ピンを変更するにはプロセスを再起動してください。ホットリロードには対応していません。

@knolo/[email protected] は、まだ npm や MCP Registry に公開されていません。server.json のレジストリ名は io.github.HiveForensics-AI/knolo です。

設定

パスは絶対パスです。sha256 は 64 文字の小文字の 16 進数です。stateRoot は sha256- の後に 64 文字の小文字の 16 進数が続きます。

{
  "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、カバレッジ、コンポジションには対応していません。