@grackle-ai/plugin-knowledge

Knowledge graph plugin for Grackle. Provides Neo4j-backed semantic search and knowledge node retrieval via the GracklePlugin interface. The graph is populated by the derived-mirror projection (epic #1256), not by agent-authored writes.

Overview

Loading this plugin opts the server into knowledge graph functionality. When enabled (GRACKLE_KNOWLEDGE_ENABLED=true), the plugin:

• Connects to Neo4j and initializes the schema
• Creates a local embedding model for semantic search
• Registers gRPC handlers for knowledge read operations
• Exposes knowledge_search and knowledge_get_node MCP tools
• Monitors Neo4j health via a reconciliation phase

Usage

import { createKnowledgePlugin } from "@grackle-ai/plugin-knowledge";

const plugins = [createCorePlugin()];
if (config.knowledgeEnabled) {
  plugins.push(createKnowledgePlugin());
}
const loaded = await loadPlugins(plugins, ctx);

gRPC Handlers

• searchKnowledge — Semantic similarity search
• getKnowledgeNode — Retrieve a node by ID
• expandKnowledgeNode — Expand a node's neighbors
• listRecentKnowledgeNodes — List recently created nodes

MCP Tools

• knowledge_search — Natural language search
• knowledge_get_node — Retrieve a node by ID