actual-mcp-server 0.5.7 → 0.5.8

package/README.md

@@ -47,6 +47,7 @@ Most Actual Budget MCP implementations are simple stdio bridges designed for sin
 ## Table of Contents
 
 - [Quick Start](#quick-start)
+- [Upgrading](#upgrading)
 - [Available Tools](#available-tools)
 - [Configuration](#configuration)
 - [Multi-Budget Switching](#multi-budget-switching)
@@ -234,6 +235,51 @@ See [docs/guides/MCP_CLIENTS_SETUP.md](docs/guides/MCP_CLIENTS_SETUP.md) for all
 
 ---
 
+## Upgrading
+
+### Docker (Option A)
+
+```bash
+docker pull ghcr.io/agigante80/actual-mcp-server:latest
+docker stop actual-mcp-server-backend
+docker rm actual-mcp-server-backend
+# Re-run the original docker run command with the same flags and volumes
+```
+
+Also available on Docker Hub: `docker pull agigante80/actual-mcp-server:latest`
+
+### Docker Compose (Option B)
+
+```bash
+docker compose pull
+docker compose --profile production up -d
+```
+
+### npm / cloned repo (Option C)
+
+```bash
+git pull
+npm install
+npm run build
+# Then restart the server
+```
+
+### npx / stdio (Options C & D)
+
+If you run `npx actual-mcp-server` without a globally installed version, npx fetches the latest from the registry automatically. But if you previously installed it globally (`npm install -g actual-mcp-server`), the global install takes precedence — you must upgrade it explicitly:
+
+```bash
+# Upgrade the global install
+npm install -g actual-mcp-server
+
+# Or force the registry version without touching your global install
+npx actual-mcp-server@latest --http
+```
+
+For Claude Desktop (stdio), restart Claude after upgrading.
+
+---
+
 ## Available Tools
 
 **63 tools** across 12 categories. All tools use the `actual_<category>_<action>` naming convention.
@@ -678,4 +724,4 @@ The software is provided **as-is**, without warranty of any kind. The author acc
 
 ---
 
-**Version:** 0.5.7 | **Tool Count:** 63 (verified LibreChat-compatible)
+**Version:** 0.5.8 | **Tool Count:** 63 (verified LibreChat-compatible)

package/dist/package.json

@@ -1,12 +1,13 @@
 {
     "name": "actual-mcp-server",
     "displayName": "Actual MCP Server",
-    "version": "0.5.7",
+    "version": "0.5.8",
     "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",
+    "description": "MCP server with 63 tools for AI-driven financial management with Actual Budget — HTTP and stdio transports, LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
+    "homepage": "https://github.com/agigante80/actual-mcp-server#readme",
     "repository": {
         "type": "git",
         "url": "https://github.com/agigante80/actual-mcp-server"

package/dist/src/index.js

@@ -89,6 +89,22 @@ if (unknownFlags.length > 0) {
     console.error(`Unknown option: ${unknownFlags.join(', ')}\nRun \`actual-mcp-server --help\` for usage.`);
     process.exit(1);
 }
+// Early transport mode check — before dotenv and dynamic imports.
+// Without this, the config validation error fires first and confuses users who
+// simply forgot to pass --http or --stdio.
+if (!argsEarly.includes('--http') &&
+    !argsEarly.includes('--stdio') &&
+    !argsEarly.includes('--test-actual-connection') &&
+    !argsEarly.includes('--test-mcp-client') &&
+    !argsEarly.includes('--help') && !argsEarly.includes('-h') &&
+    !argsEarly.includes('--version') && !argsEarly.includes('-v')) {
+    console.error('No transport mode specified.\n\n' +
+        'Usage:\n' +
+        '  actual-mcp-server --http        # HTTP server (LibreChat / LobeChat / multi-user)\n' +
+        '  actual-mcp-server --stdio       # stdio transport (Claude Desktop / Claude Code)\n\n' +
+        'Run actual-mcp-server --help for all options.\n');
+    process.exit(1);
+}
 if (argsEarly.includes('--help') || argsEarly.includes('-h') ||
     argsEarly.includes('--version') || argsEarly.includes('-v')) {
     const pkg = await import('../package.json', { with: { type: 'json' } });

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "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",
+  "description": "MCP server with 63 tools for AI-driven financial management with Actual Budget — HTTP and stdio transports, LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
+  "homepage": "https://github.com/agigante80/actual-mcp-server#readme",
   "repository": {
     "type": "git",
     "url": "https://github.com/agigante80/actual-mcp-server"