entroly-mcp 0.4.0 → 0.8.5

package/README.md

@@ -1,32 +1,64 @@
-# @ebbiforge/entroly-mcp
-
-NPM bridge for the Entroly MCP server. This package wraps the Python `entroly` CLI so you can use it with Cursor, VS Code, and other MCP clients that prefer npm-based tool installation.
-
-## Prerequisites
-
-You need the Python `entroly` package installed:
-
-```bash
-pip install entroly
-```
-
-## Usage with Cursor
-
-Add to your Cursor MCP config (`.cursor/mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "entroly": {
-      "command": "npx",
-      "args": ["-y", "@ebbiforge/entroly-mcp"]
-    }
-  }
-}
-```
-
-## What this does
-
-This is a **thin bridge** — it simply calls `entroly serve` under the hood. All the actual context optimization runs in the Entroly Python package backed by the `entroly-core` Rust engine.
-
-For more info, see the [main repo](https://github.com/juyterman1000/entroly).
+# @ebbiforge/entroly-mcp
+
+An MCP (Model Context Protocol) server for information-theoretic context optimization. 
+Use it to optimize Claude/Cursor's context window by selecting only the most relevant, high-entropy, and critical code fragments based on a Knapsack constraint.
+
+## Installation & Usage
+
+This package is a universal `npx` bridge to the Entroly Python engine.
+
+You can use it directly in any MCP-compatible client like Cursor or Claude Desktop:
+
+### Method 1: entroly-wasm (Recommended — zero dependencies)
+```json
+{
+  "mcpServers": {
+    "entroly": {
+      "command": "npx",
+      "args": ["-y", "entroly-wasm", "serve"],
+      "env": {
+        "ENTROLY_BUDGET": "200000"
+      }
+    }
+  }
+}
+```
+
+### Method 2: NPX Bridge to Python (requires `pip install entroly`)
+```json
+{
+  "mcpServers": {
+    "entroly": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@ebbiforge/entroly-mcp",
+        "serve"
+      ],
+      "env": {
+        "ENTROLY_BUDGET": "200000"
+      }
+    }
+  }
+}
+```
+
+*Note: You must have the core Python engine installed on your system:*
+```bash
+pip install entroly
+# or
+pipx install entroly
+```
+
+### Features
+
+- **Knapsack Token Optimization**: Fits the absolute maximum value into your token budget.
+- **Shannon Entropy Scoring**: Prioritizes complex, high-entropy logic over repetitive boilerplate.
+- **SimHash Deduplication**: Never wastes tokens on duplicate file contents.
+- **Predictive Pre-fetch**: Learns your co-access patterns to predict what file you'll need next.
+- **Feedback Loop**: Agentic feedback (`record_success` / `record_failure`) continuously tunes the RL weights.
+
+## Links
+
+- **PyPI**: [entroly](https://pypi.org/project/entroly/)
+- **Repository**: [juyterman1000/entroly](https://github.com/juyterman1000/entroly)

package/index.js

@@ -1,33 +1,33 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require('child_process');
-const path = require('path');
-
-// Pass all arguments straight through to the Python MCP server
-const args = process.argv.slice(2);
-
-// Check if 'entroly' command is available (installed via pip/pipx)
-const checkCmd = process.platform === 'win32' ? 'where' : 'which';
-const checkStatus = spawnSync(checkCmd, ['entroly'], { stdio: 'ignore' });
-
-if (checkStatus.status !== 0) {
-  console.error("=====================================================================");
-  console.error("  Error: 'entroly' Python package is not installed.");
-  console.error("");
-  console.error("  The @ebbiforge/entroly-mcp package is a bridge. To use it,");
-  console.error("  you must have the Python engine installed on your system.");
-  console.error("");
-  console.error("  Please run:");
-  console.error("      pip install entroly");
-  console.error("  or");
-  console.error("      pipx install entroly");
-  console.error("=====================================================================");
-  process.exit(1);
-}
-
-// Spawn the Python process, replacing the current node process's stdio directly
-const pyProcess = spawnSync('entroly', args, {
-  stdio: 'inherit'
-});
-
-process.exit(pyProcess.status !== null ? pyProcess.status : 1);
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+
+// Pass all arguments straight through to the Python MCP server
+const args = process.argv.slice(2);
+
+// Check if 'entroly' command is available (installed via pip/pipx)
+const checkCmd = process.platform === 'win32' ? 'where' : 'which';
+const checkStatus = spawnSync(checkCmd, ['entroly'], { stdio: 'ignore' });
+
+if (checkStatus.status !== 0) {
+  console.error("=====================================================================");
+  console.error("  Error: 'entroly' Python package is not installed.");
+  console.error("");
+  console.error("  The @ebbiforge/entroly-mcp package is a bridge. To use it,");
+  console.error("  you must have the Python engine installed on your system.");
+  console.error("");
+  console.error("  Please run:");
+  console.error("      pip install entroly");
+  console.error("  or");
+  console.error("      pipx install entroly");
+  console.error("=====================================================================");
+  process.exit(1);
+}
+
+// Spawn the Python process, replacing the current node process's stdio directly
+const pyProcess = spawnSync('entroly', args, {
+  stdio: 'inherit'
+});
+
+process.exit(pyProcess.status !== null ? pyProcess.status : 1);

package/package.json

@@ -1,33 +1,25 @@
-{
-  "name": "entroly-mcp",
-  "version": "0.4.0",
-  "description": "Information-theoretic context optimization MCP server for AI coding agents. Bridge package that wraps the Entroly Python engine.",
-  "main": "index.js",
-  "bin": {
-    "entroly-mcp": "index.js"
-  },
-  "files": [
-    "index.js",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node index.js --help || true"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/juyterman1000/entroly"
-  },
-  "homepage": "https://github.com/juyterman1000/entroly",
-  "keywords": [
-    "mcp",
-    "context-optimization",
-    "entroly",
-    "ai",
-    "agents",
-    "cursor",
-    "claude",
-    "vscode"
-  ],
-  "author": "Ebbiforge Team",
-  "license": "MIT"
-}
+{
+  "name": "entroly-mcp",
+  "version": "0.8.5",
+  "description": "Information-theoretic context optimization MCP server for AI coding agents.",
+  "main": "index.js",
+  "bin": {
+    "entroly-mcp": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"No JS tests yet\""
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/juyterman1000/entroly"
+  },
+  "keywords": [
+    "mcp",
+    "context-optimization",
+    "entroly",
+    "ai",
+    "agents"
+  ],
+  "author": "entroly",
+  "license": "Apache-2.0"
+}