actual-mcp-server 0.5.0 → 0.5.3

package/README.md

@@ -128,6 +128,14 @@ docker compose --profile fullstack up -d    # includes Actual Budget server on :
 ### Option C — npm (HTTP server)
 
 ```bash
+# Quick start via npx (no clone needed):
+ACTUAL_SERVER_URL=http://localhost:5006 \
+ACTUAL_PASSWORD=your_password \
+ACTUAL_BUDGET_SYNC_ID=your-sync-id \
+MCP_SSE_AUTHORIZATION=your_token \
+npx actual-mcp-server --http
+
+# Or clone for development / custom config:
 git clone https://github.com/agigante80/actual-mcp-server.git
 cd actual-mcp-server
 npm install
@@ -660,4 +668,4 @@ The software is provided **as-is**, without warranty of any kind. The author acc
 
 ---
 
-**Version:** 0.5.0 | **Tool Count:** 62 (verified LibreChat-compatible)
+**Version:** 0.5.2 | **Tool Count:** 62 (verified LibreChat-compatible)

package/dist/package.json

@@ -1,8 +1,16 @@
 {
     "name": "actual-mcp-server",
     "displayName": "Actual MCP Server",
-    "version": "0.5.0",
+    "version": "0.5.3",
+    "engines": {
+        "node": ">=20.0.0",
+        "npm": ">=10.0.0"
+    },
     "description": "MCP server with 62 tools for AI-driven financial management with Actual Budget — HTTP and stdio transports, LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/agigante80/actual-mcp-server"
+    },
     "main": "dist/src/index.js",
     "bin": {
         "actual-mcp-server": "./bin/actual-mcp-server.js"

package/dist/src/index.js

@@ -72,6 +72,10 @@ const argsEarly = process.argv.slice(2);
 // whether to route all output to stderr (required in stdio mode — stdout writes corrupt JSON-RPC).
 if (argsEarly.includes('--stdio')) {
     process.env.MCP_STDIO_MODE = 'true';
+    // dotenv v17 outputs diagnostic text to stdout by default (console.log).
+    // In stdio mode stdout is the JSON-RPC channel — any non-JSON output corrupts
+    // the framing and causes MCP clients to close the connection immediately.
+    process.env.DOTENV_CONFIG_QUIET = 'true';
 }
 // Only load dotenv if we're not just showing help
 // dotenv will be loaded inside the async IIFE below via dynamic import

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.5.0",
+  "version": "0.5.3",
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  },
   "description": "MCP server with 62 tools for AI-driven financial management with Actual Budget — HTTP and stdio transports, LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agigante80/actual-mcp-server"
+  },
   "main": "dist/src/index.js",
   "bin": {
     "actual-mcp-server": "./bin/actual-mcp-server.js"