modelbrain-mcp 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Firth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# modelbrain-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A thin [MCP](https://modelcontextprotocol.io) stdio client for [ModelBrain](https://modelbrain.net): a memory layer for AI assistants that runs on your own computer.
+
+This package does not install or bundle ModelBrain. It connects to the ModelBrain desktop app already running on your machine. If ModelBrain is not installed, running this prints where to get it and exits, rather than failing silently.
+
+## Why a separate package
+
+ModelBrain's own installed app already ships a binary, `mcp_server`, that speaks MCP over stdio and talks to the local ModelBrain daemon. This package finds that binary on the current machine and runs it. It exists so ModelBrain can be registered with the MCP Registry and the directories that list from it, with a reviewable package as the distribution target, while the actual engine stays out of this repository.
+
+## Requirements
+
+- macOS (Apple Silicon) or Windows (x64 or arm64)
+- [ModelBrain](https://modelbrain.net/get-it.html) installed
+
+## Use
+
+Most MCP clients run a server with `npx`. Point your client's MCP config at:
+
+```json
+{
+  "mcpServers": {
+    "modelbrain": {
+      "command": "npx",
+      "args": ["-y", "modelbrain-mcp"]
+    }
+  }
+}
+```
+
+Claude Desktop, Claude Code and Cursor users do not need this: ModelBrain's own app registers itself with those clients directly. See [modelbrain.net/docs](https://modelbrain.net/docs.html) for the full tool surface (`remember`, `recall`, `forget`, `expand`, `connector_sync`) and the [connect guides](https://modelbrain.net/docs.html#guides) for other clients.
+
+## License
+
+MIT, for this wrapper package. ModelBrain itself is separate, proprietary software; see [modelbrain.net](https://modelbrain.net) for its own terms.
+
+## Security
+
+See [SECURITY.md](SECURITY.md).

package/SECURITY.md

@@ -0,0 +1,13 @@
+# Security
+
+## Reporting a vulnerability
+
+Email security@modelbrain.net with a description and steps to reproduce. Please do not open a public issue for security reports.
+
+We acknowledge reports within 72 hours and aim to ship a fix or a mitigation within 90 days. We ask for the same window before public disclosure.
+
+## What this package does
+
+`modelbrain-mcp` is a small launcher. It finds the `mcp_server` binary that the ModelBrain desktop app installs on your computer and runs it, passing stdio through. It makes no network requests, reads no files other than checking for the installed binary, and stores nothing.
+
+The ModelBrain app itself is separate software. Its data stays on your computer. See https://modelbrain.net/privacy.html for what leaves the machine and what does not.

package/bin/modelbrain-mcp.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+'use strict';
+
+// Thin stdio client for ModelBrain (https://modelbrain.net).
+//
+// This package does not bundle ModelBrain or talk to its daemon directly.
+// ModelBrain's own installed app already ships a binary, mcp_server, that
+// does exactly that (connects to the resident daemon over a Unix socket on
+// macOS or a named pipe on Windows, spawning the daemon on demand, then
+// relays raw MCP bytes between its own stdio and that connection). This
+// wrapper's only job is to find that binary on the current machine and
+// exec it, or say plainly that it is not installed.
+//
+// Why a wrapper at all, instead of pointing a client straight at the
+// installed binary: the MCP Registry, and directories that ingest from it,
+// want a published package as the distribution target. This is that
+// package, kept deliberately thin.
+
+const { spawn } = require('node:child_process');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+function macCandidates() {
+  const home = os.homedir();
+  return [
+    '/Applications/ModelBrain.app/Contents/MacOS/mcp_server',
+    path.join(home, 'Applications/ModelBrain.app/Contents/MacOS/mcp_server'),
+  ];
+}
+
+function windowsCandidates() {
+  const localAppData = process.env.LOCALAPPDATA;
+  if (!localAppData) return [];
+  return [path.join(localAppData, 'Programs', 'ModelBrain', 'mcp_server.exe')];
+}
+
+function candidatesForPlatform() {
+  if (process.platform === 'darwin') return macCandidates();
+  if (process.platform === 'win32') return windowsCandidates();
+  return [];
+}
+
+function findServerBinary() {
+  for (const candidate of candidatesForPlatform()) {
+    try {
+      fs.accessSync(candidate, fs.constants.X_OK);
+      return candidate;
+    } catch {
+      // Not there, or not executable. Try the next candidate.
+    }
+  }
+  return null;
+}
+
+function notFoundMessage() {
+  const lines = [
+    'ModelBrain desktop app not detected on this computer.',
+    '',
+    'modelbrain-mcp is a thin client: it connects to the ModelBrain app',
+    'already running on your machine. It does not install or bundle',
+    'ModelBrain itself.',
+    '',
+  ];
+  if (process.platform === 'darwin' || process.platform === 'win32') {
+    lines.push('Install ModelBrain, then run this again: https://modelbrain.net/get-it.html');
+  } else {
+    lines.push(
+      `${process.platform} is not part of this launch. ModelBrain currently`,
+      'ships for macOS (Apple Silicon) and Windows (x64 and arm64) only:',
+      'https://modelbrain.net/get-it.html'
+    );
+  }
+  return lines.join('\n');
+}
+
+function main() {
+  const binaryPath = findServerBinary();
+
+  if (!binaryPath) {
+    process.stderr.write(notFoundMessage() + '\n');
+    process.exitCode = 1;
+    return;
+  }
+
+  const child = spawn(binaryPath, process.argv.slice(2), { stdio: 'inherit' });
+
+  child.on('error', (err) => {
+    process.stderr.write(`Failed to start ModelBrain's MCP server: ${err.message}\n`);
+    process.exitCode = 1;
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exitCode = code === null ? 1 : code;
+  });
+}
+
+main();

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "modelbrain-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Thin MCP stdio client for ModelBrain, a local memory layer for AI assistants. Connects to the ModelBrain desktop app already running on your computer; does not bundle ModelBrain itself.",
+  "bin": {
+    "modelbrain-mcp": "bin/modelbrain-mcp.js"
+  },
+  "main": "bin/modelbrain-mcp.js",
+  "files": [
+    "bin/modelbrain-mcp.js",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "author": "Matthew Firth <hello@modelbrain.net> (https://modelbrain.net)",
+  "homepage": "https://modelbrain.net",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "modelbrain",
+    "memory",
+    "ai-memory",
+    "local-first"
+  ],
+  "os": [
+    "darwin",
+    "win32"
+  ],
+  "mcpName": "net.modelbrain/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/modelbrain/modelbrain-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/modelbrain/modelbrain-mcp/issues"
+  }
+}