nodebb-plugin-integration 0.3.0

package/library.js

@@ -0,0 +1,171 @@
+"use strict";
+
+/**
+ * NodeBB Integration Layer
+ *
+ * Main plugin entry point
+ */
+
+require("dotenv").config();
+
+const Config = require("./src/config");
+const Routes = require("./src/routes");
+const Events = require("./src/events");
+const Indexer = require("./src/ai/indexer");
+const MCP = require("./src/mcp/server");
+
+
+const Plugin = {};
+
+
+/**
+ * NodeBB hook:
+ *
+ * static:app.load
+ */
+Plugin.init = async function ({ router } = {}) {
+
+    console.log(
+        "[NodeBB Integration] initializing"
+    );
+
+
+    if (router) {
+
+        Routes.init(
+            router
+        );
+
+    } else {
+
+        console.log(
+            "[NodeBB Integration] router unavailable (standalone mode)"
+        );
+
+    }
+
+
+    if (
+        Events &&
+        typeof Events.init === "function"
+    ) {
+
+        await Events.init();
+
+    }
+
+
+    if (
+        Config?.mcp?.enabled &&
+        process.env.MCP_AUTOSTART === "true" &&
+        MCP &&
+        typeof MCP.start === "function"
+    ) {
+
+        await MCP.start();
+
+        console.log(
+            "[NodeBB Integration] MCP started"
+        );
+
+    }
+
+
+    console.log(
+        "[NodeBB Integration] ready"
+    );
+
+};
+
+
+/**
+ * NodeBB hook:
+ *
+ * action:post.save
+ */
+Plugin.onPostSave = async function (post) {
+
+    try {
+
+        if (
+            Events &&
+            typeof Events.postSave === "function"
+        ) {
+
+            await Events.postSave(
+                post
+            );
+
+        }
+
+
+        if (
+            Indexer &&
+            typeof Indexer.indexPost === "function"
+        ) {
+
+            await Indexer.indexPost(
+                post
+            );
+
+        }
+
+
+    } catch (error) {
+
+        console.error(
+            "[Plugin] post save error",
+            error.message
+        );
+
+    }
+
+};
+
+
+/**
+ * NodeBB hook:
+ *
+ * action:topic.save
+ */
+Plugin.onTopicSave = async function (topic) {
+
+    try {
+
+        if (
+            Events &&
+            typeof Events.topicCreate === "function"
+        ) {
+
+            await Events.topicCreate(
+                topic
+            );
+
+        }
+
+
+        if (
+            Indexer &&
+            typeof Indexer.indexTopic === "function"
+        ) {
+
+            await Indexer.indexTopic(
+                topic
+            );
+
+        }
+
+
+    } catch (error) {
+
+        console.error(
+            "[Plugin] topic save error",
+            error.message
+        );
+
+    }
+
+};
+
+
+module.exports = Plugin;

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "nodebb-plugin-integration",
+  "version": "0.3.0",
+  "description": "AI integration layer for NodeBB forums with MCP, semantic search, RAG and Qdrant knowledge pipeline",
+  "main": "library.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sergey-ek/nodebb-plugin-integration.git"
+  },
+  "keywords": [
+    "nodebb",
+    "nodebb-plugin",
+    "ai",
+    "mcp",
+    "model-context-protocol",
+    "rag",
+    "qdrant",
+    "embeddings",
+    "semantic-search",
+    "knowledge-base"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "library.js",
+    "plugin.json",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "cross-env NODE_ENV=test mocha test/*.test.js",
+    "check": "node --check library.js && node --check src/routes/index.js && node --check src/routes/api.js && node --check src/mcp/server.js && node --check src/mcp/tools.js",
+    "diagnose": "node -e \"console.log(require('./src/config').info())\"",
+    "mcp": "node src/mcp/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@qdrant/js-client-rest": "^1.12.0",
+    "dotenv": "^16.4.7",
+    "node-fetch": "^3.3.2",
+    "openai": "^6.45.0"
+  },
+  "devDependencies": {
+    "cross-env": "^10.0.0",
+    "mocha": "^11.7.6"
+  },
+  "nbbpm": {
+    "compatibility": "^4.4.1"
+  }
+}

package/plugin.json

@@ -0,0 +1,23 @@
+{
+  "id": "nodebb-plugin-integration",
+  "name": "NodeBB Integration Layer",
+  "description": "AI integration layer for NodeBB with MCP, semantic search, RAG and Qdrant knowledge pipeline",
+  "library": "./library.js",
+  "staticDirs": {
+    "public": "public"
+  },
+  "hooks": [
+    {
+      "hook": "static:app.load",
+      "method": "init"
+    },
+    {
+      "hook": "action:post.save",
+      "method": "onPostSave"
+    },
+    {
+      "hook": "action:topic.save",
+      "method": "onTopicSave"
+    }
+  ]
+}

package/src/ai/embeddings.js

@@ -0,0 +1,254 @@
+"use strict";
+
+
+/*
+ * NodeBB Integration Layer
+ *
+ * Embeddings Service
+ *
+ * Unified interface for:
+ *
+ * - OpenAI embeddings
+ * - Fake test embeddings
+ *
+ */
+
+
+
+const Config =
+    require("../config");
+
+
+const OpenAI =
+    require("./openai");
+
+
+
+
+
+
+
+/*
+ * Embedding size
+ *
+ * text-embedding-3-small = 1536
+ */
+
+
+const SIZE =
+
+    Number(
+
+        process.env.EMBEDDING_SIZE ||
+
+        1536
+
+    );
+
+
+
+
+
+
+
+
+
+/*
+ * Generate fake vector
+ *
+ * Used for:
+ *
+ * - tests
+ * - development
+ *
+ */
+
+
+function fakeEmbedding() {
+
+
+    const vector = [];
+
+
+
+    for(let i = 0; i < SIZE; i++) {
+
+
+        vector.push(
+
+            Math.random()
+
+        );
+
+
+    }
+
+
+
+    return vector;
+
+
+}
+
+
+
+
+
+
+
+
+
+/*
+ * Select provider
+ */
+
+
+function provider() {
+
+
+
+    return (
+
+        process.env.AI_PROVIDER ||
+
+        "fake"
+
+    );
+
+
+}
+
+
+
+
+
+
+
+
+
+/*
+ * Create embedding
+ */
+
+
+async function create(text) {
+
+
+
+    if(!text || !text.trim()) {
+
+
+        return null;
+
+
+    }
+
+
+
+
+
+
+
+
+    /*
+     * OpenAI mode
+     */
+
+
+    if(
+
+        provider() === "openai"
+
+    ) {
+
+
+
+        const vector =
+
+            await OpenAI.embeddings(
+
+                text
+
+            );
+
+
+
+
+
+        return vector;
+
+
+    }
+
+
+
+
+
+
+
+
+    /*
+     * Development/Test mode
+     */
+
+
+    return fakeEmbedding();
+
+
+
+}
+
+
+
+
+
+
+
+
+
+/*
+ * Service information
+ */
+
+
+function info() {
+
+
+    return {
+
+
+        provider:
+            provider(),
+
+
+        size:
+            SIZE
+
+
+    };
+
+
+}
+
+
+
+
+
+
+
+
+
+module.exports = {
+
+
+    create,
+
+
+    info,
+
+
+    SIZE
+
+
+
+};