brainllm 10.1.0

package/manifest.json

@@ -0,0 +1,72 @@
+{
+  "dxt_version": "0.1",
+  "name": "brainllm",
+  "display_name": "BrainLLM",
+  "version": "10.1.0",
+  "description": "Turns TriliumNext Notes into a persistent, graph-structured second brain for Claude and other LLM clients.",
+  "long_description": "BrainLLM is an MCP server that organises memory into five purpose-built areas (Master, LLM, Memory, Knowledge, Insights). The model supplies content while the server owns placement, format, lifecycle, dates and backups. Includes a full raw ETAPI surface for advanced use. Requires a running TriliumNext instance and the Bun runtime.",
+  "author": {
+    "name": "Kevin Miiso",
+    "email": "miisodev@gmail.com",
+    "url": "https://github.com/miisodev"
+  },
+  "homepage": "https://github.com/miisodev/BrainLLM#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/miisodev/BrainLLM.git"
+  },
+  "support": "https://github.com/miisodev/BrainLLM/issues",
+  "license": "MIT",
+  "keywords": ["mcp", "trilium", "trilium-next", "second-brain", "knowledge-graph", "memory", "claude"],
+  "icon": "public/BrainLLM.png",
+  "server": {
+    "type": "binary",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "bun",
+      "args": ["run", "${__dirname}/dist/index.js"],
+      "env": {
+        "TRILIUM_BASE_URL": "${user_config.trilium_base_url}",
+        "TRILIUM_ETAPI_TOKEN": "${user_config.trilium_etapi_token}",
+        "BRAINLLM_MODE": "${user_config.brainllm_mode}",
+        "BRAINLLM_TZ": "${user_config.brainllm_tz}"
+      }
+    }
+  },
+  "tools_generated": true,
+  "user_config": {
+    "trilium_base_url": {
+      "type": "string",
+      "title": "Trilium base URL",
+      "description": "URL of your TriliumNext instance.",
+      "default": "http://localhost:8080",
+      "required": true
+    },
+    "trilium_etapi_token": {
+      "type": "string",
+      "title": "Trilium ETAPI token",
+      "description": "Create one in Trilium: Options -> ETAPI -> Create token.",
+      "required": true,
+      "sensitive": true
+    },
+    "brainllm_mode": {
+      "type": "string",
+      "title": "Tool surface",
+      "description": "core (default) or full (adds the 33 raw ETAPI tools).",
+      "default": "core",
+      "required": false
+    },
+    "brainllm_tz": {
+      "type": "string",
+      "title": "Timezone (IANA)",
+      "description": "Optional. e.g. America/New_York. Leave blank to use the host clock.",
+      "required": false
+    }
+  },
+  "compatibility": {
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "bun": ">=1.0.0"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "brainllm",
+  "version": "10.1.0",
+  "description": "MCP server that turns TriliumNext Notes into a persistent, graph-structured second brain for Claude and other LLM clients.",
+  "author": "Kevin Miiso Novo <miisodev@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/miisodev/BrainLLM.git"
+  },
+  "homepage": "https://github.com/miisodev/BrainLLM#readme",
+  "bugs": {
+    "url": "https://github.com/miisodev/BrainLLM/issues"
+  },
+  "funding": [
+    "https://github.com/sponsors/miisodev",
+    "https://paypal.me/miisodev"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "trilium",
+    "trilium-next",
+    "second-brain",
+    "knowledge-graph",
+    "llm",
+    "claude",
+    "ai"
+  ],
+  "bin": {
+    "brainllm": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist/index.js",
+    "public/",
+    "skills/brainllm/",
+    "config.example.json",
+    ".env.example",
+    "manifest.json",
+    "server.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "build": "bun build src/index.ts --outfile dist/index.js --target bun",
+    "start": "bun run dist/index.js",
+    "test": "bun run src/test.ts",
+    "init": "bun run src/init.ts",
+    "icons": "bun run scripts/icons.ts",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "sharp": "^0.35.3",
+    "typescript": "^5.0.0"
+  }
+}

package/public/BrainLLM.svg

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  BrainLLM mark.
+
+  A 3x3 grid of nodes, six lit and three dark — the same figure the site's
+  wordmark carries. It reads as a small graph rather than a brain, which is
+  what the product actually is: typed nodes, some connected, some not yet.
+
+  Geometry is exact so it stays crisp at every raster size: a 512 canvas, dots
+  of r=38 on a 92px pitch, centred on 164 / 256 / 348 in both axes.
+
+  The plate is part of the mark, not a backdrop. Rasterised icons are served
+  into favicon and connector slots that sit on unknown backgrounds, and amber
+  dots alone would disappear against a light one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" role="img" aria-label="BrainLLM">
+  <defs>
+    <radialGradient id="glow" cx="50%" cy="42%" r="52%">
+      <stop offset="0%" stop-color="#f59e0b" stop-opacity="0.20"/>
+      <stop offset="100%" stop-color="#f59e0b" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <rect width="512" height="512" rx="114" fill="#0a0a0f"/>
+  <rect width="512" height="512" rx="114" fill="url(#glow)"/>
+  <rect x="1" y="1" width="510" height="510" rx="113" fill="none" stroke="#ffffff" stroke-opacity="0.09" stroke-width="2"/>
+
+  <g fill="#f59e0b">
+    <circle cx="164" cy="164" r="38"/>
+    <circle cx="348" cy="164" r="38"/>
+    <circle cx="164" cy="256" r="38"/>
+    <circle cx="256" cy="256" r="38"/>
+    <circle cx="256" cy="348" r="38"/>
+    <circle cx="348" cy="348" r="38"/>
+  </g>
+  <g fill="#3f3f46">
+    <circle cx="256" cy="164" r="38"/>
+    <circle cx="348" cy="256" r="38"/>
+    <circle cx="164" cy="348" r="38"/>
+  </g>
+</svg>

package/server.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "name": "io.github.miisodev/brainllm",
+  "description": "Persistent, graph-structured memory for LLMs, stored in TriliumNext Notes. Enforced note structure, a session protocol with a durable pre-close gate, a typed knowledge graph, and a maintenance lifecycle — in a note application the human can read and edit too.",
+  "version": "10.1.0",
+  "websiteUrl": "https://github.com/miisodev/BrainLLM#readme",
+  "repository": {
+    "url": "https://github.com/miisodev/BrainLLM",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "brainllm",
+      "version": "10.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "TRILIUM_BASE_URL",
+          "description": "Base URL of the TriliumNext instance, e.g. http://localhost:8080",
+          "isRequired": true,
+          "format": "string"
+        },
+        {
+          "name": "TRILIUM_ETAPI_TOKEN",
+          "description": "ETAPI token. Required unless TRILIUM_PASSWORD is set. Create one in Trilium under Options → ETAPI.",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
+        },
+        {
+          "name": "TRILIUM_PASSWORD",
+          "description": "Alternative to TRILIUM_ETAPI_TOKEN — BrainLLM mints a token on first start and caches it beside brainllm.json.",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
+        },
+        {
+          "name": "BRAINLLM_MODE",
+          "description": "core (default) exposes the 39 brain-aware tools; full additionally exposes the 33 raw ETAPI tools.",
+          "isRequired": false,
+          "format": "string",
+          "default": "core"
+        },
+        {
+          "name": "BRAINLLM_TZ",
+          "description": "IANA timezone used to stamp dated notes, e.g. Africa/Johannesburg. Defaults to the host timezone.",
+          "isRequired": false,
+          "format": "string"
+        },
+        {
+          "name": "BRAINLLM_OWNER_PASSWORD",
+          "description": "Enables the OAuth 2.1 / CIMD endpoints required by claude.ai and other hosted Claude surfaces. This is the password entered on the consent screen when authorizing a client.",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
+        },
+        {
+          "name": "BRAINLLM_PUBLIC_URL",
+          "description": "Override for the public origin when a proxy rewrites Host. Must exactly match the URL entered in the client.",
+          "isRequired": false,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}