nucleus-mcp 1.7.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +44 -0
  2. package/index.js +12 -3
  3. package/package.json +2 -1
package/README.md ADDED
@@ -0,0 +1,44 @@
1
+ # nucleus-mcp
2
+
3
+ Sovereign Agent OS — Persistent Memory, Governance & Compliance for AI Agents.
4
+
5
+ 114 MCP tools. Three reliability frontiers: GROUND (verify), ALIGN (correct), COMPOUND (learn).
6
+
7
+ ## Install
8
+
9
+ ### Native (one command per IDE)
10
+
11
+ | IDE | Command |
12
+ |-----|---------|
13
+ | **Claude Code** | `claude mcp add nucleus -- uvx nucleus-mcp` |
14
+ | **Cursor** | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=nucleus&config=eyJuYW1lIjoibnVjbGV1cyIsInR5cGUiOiJjb21tYW5kIiwiY29tbWFuZCI6Im5weCIsImFyZ3MiOlsiLXkiLCJudWNsZXVzLW1jcCJdfQ==) |
15
+ | **Any IDE** | `pip install nucleus-mcp && nucleus init` |
16
+
17
+ ### Manual Config
18
+
19
+ Pick your runtime:
20
+
21
+ **uvx** (zero install):
22
+ ```json
23
+ { "mcpServers": { "nucleus": { "command": "uvx", "args": ["nucleus-mcp"], "env": { "NUCLEAR_BRAIN_PATH": ".brain" } } } }
24
+ ```
25
+
26
+ **npx** (zero install):
27
+ ```json
28
+ { "mcpServers": { "nucleus": { "command": "npx", "args": ["-y", "nucleus-mcp"], "env": { "NUCLEAR_BRAIN_PATH": ".brain" } } } }
29
+ ```
30
+
31
+ **pip** (`pip install nucleus-mcp` first):
32
+ ```json
33
+ { "mcpServers": { "nucleus": { "command": "nucleus-mcp", "env": { "NUCLEAR_BRAIN_PATH": ".brain" } } } }
34
+ ```
35
+
36
+ ## Links
37
+
38
+ - [Full docs](https://github.com/eidetic-works/nucleus-mcp)
39
+ - [PyPI](https://pypi.org/project/nucleus-mcp/)
40
+ - [Discord](https://discord.gg/RJuBNNJ5MT)
41
+
42
+ ## License
43
+
44
+ MIT
package/index.js CHANGED
@@ -34,7 +34,8 @@ function install() {
34
34
  return true;
35
35
  } catch (e) {
36
36
  console.error('[Nucleus] ERROR: Failed to install nucleus-mcp via pip.');
37
- console.error(e.message);
37
+ console.error('[Nucleus] Try manually: python3 -m pip install nucleus-mcp');
38
+ console.error('[Nucleus] If pip is missing: python3 -m ensurepip --upgrade');
38
39
  return false;
39
40
  }
40
41
  }
@@ -42,6 +43,10 @@ function install() {
42
43
  async function run() {
43
44
  if (!checkPython()) {
44
45
  console.error('[Nucleus] ERROR: python3 is not installed or not in PATH.');
46
+ console.error('[Nucleus] Install Python 3.9+ from https://www.python.org/downloads/');
47
+ console.error('[Nucleus] macOS: brew install python3');
48
+ console.error('[Nucleus] Ubuntu/Debian: sudo apt install python3 python3-pip');
49
+ console.error('[Nucleus] Windows: https://www.python.org/downloads/');
45
50
  process.exit(1);
46
51
  }
47
52
 
@@ -55,9 +60,13 @@ async function run() {
55
60
  const binName = path.basename(process.argv[1]);
56
61
  const args = process.argv.slice(2);
57
62
 
63
+ // Route: explicit init subcommand or nucleus-init bin name
64
+ const isInit = binName === 'nucleus-init' || args[0] === 'init';
65
+
58
66
  let pythonArgs = [];
59
- if (binName === 'nucleus-init') {
60
- pythonArgs = ['-m', 'mcp_server_nucleus.cli', ...args];
67
+ if (isInit) {
68
+ const initArgs = args[0] === 'init' ? args.slice(1) : args;
69
+ pythonArgs = ['-m', 'mcp_server_nucleus.cli', 'init', ...initArgs];
61
70
  } else {
62
71
  pythonArgs = ['-m', 'mcp_server_nucleus', ...args];
63
72
  }
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "nucleus-mcp",
3
- "version": "1.7.0",
3
+ "version": "1.8.1",
4
+ "mcpName": "io.github.eidetic-works/nucleus",
4
5
  "description": "Sovereign Agent OS — Persistent Memory, Governance & Compliance for AI Agents",
5
6
  "main": "index.js",
6
7
  "bin": {