actual-mcp-server 0.5.1 → 0.5.4

package/README.md

@@ -668,4 +668,4 @@ The software is provided **as-is**, without warranty of any kind. The author acc
 
 ---
 
-**Version:** 0.5.1 | **Tool Count:** 62 (verified LibreChat-compatible)
+**Version:** 0.5.4 | **Tool Count:** 62 (verified LibreChat-compatible)

package/dist/package.json

@@ -1,7 +1,11 @@
 {
     "name": "actual-mcp-server",
     "displayName": "Actual MCP Server",
-    "version": "0.5.1",
+    "version": "0.5.4",
+    "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",

package/dist/src/index.js

@@ -67,6 +67,10 @@ process.on('uncaughtException', (error) => {
 });
 // Minimal early help handling before any side-effectful modules (prevents dotenv from running on --help)
 const argsEarly = process.argv.slice(2);
+// dotenv v17 outputs diagnostic text to stdout by default (console.log).
+// Suppress it unconditionally — in stdio mode stdout is the JSON-RPC channel
+// (non-JSON corrupts the framing), and in other modes the diagnostic is noise.
+process.env.DOTENV_CONFIG_QUIET = 'true';
 // Set MCP_STDIO_MODE before the async IIFE so it is in place when src/logger.ts is first
 // imported. The Winston Console transport reads this env var at construction time to decide
 // whether to route all output to stderr (required in stdio mode — stdout writes corrupt JSON-RPC).
@@ -76,19 +80,28 @@ if (argsEarly.includes('--stdio')) {
 // Only load dotenv if we're not just showing help
 // dotenv will be loaded inside the async IIFE below via dynamic import
 // to avoid using require() in ESM and to keep the early --help fast exit.
-const usageEarly = `
-Usage: npm run dev -- [--http | --stdio | --test-actual-connection | --test-actual-tools] [--debug] [--help]
+if (argsEarly.includes('--help') || argsEarly.includes('-h') ||
+    argsEarly.includes('--version') || argsEarly.includes('-v')) {
+    const pkg = await import('../package.json', { with: { type: 'json' } });
+    const version = pkg.default.version;
+    if (argsEarly.includes('--version') || argsEarly.includes('-v')) {
+        console.log(version);
+    }
+    else {
+        console.log(`actual-mcp-server v${version}
+
+Usage: actual-mcp-server [--http | --stdio | --test-actual-connection] [--debug] [--help]
 
 Options:
   --http                   Start HTTP MCP server
   --stdio                  Start stdio MCP server (for Claude Desktop / local clients)
   --test-actual-connection Test connecting to Actual and exit
-  --test-actual-tools      Test connecting and run all tools, then exit
   --debug                  Enable debug logging
-  --help                   Show this help message
-`;
-if (argsEarly.includes('--help')) {
-    console.log(usageEarly);
+  --version, -v            Print version and exit
+  --help, -h               Show this help message
+
+Docs & source: https://github.com/agigante80/actual-mcp-server`);
+    }
     process.exit(0);
 }
 (async () => {
@@ -108,9 +121,8 @@ if (argsEarly.includes('--help')) {
         console.log('Debug mode enabled: DEBUG=* LOG_LEVEL=debug');
     }
     // dynamic imports to avoid running side effects on module import
-    const [{ connectToActual }, { testAllTools }, { ActualMCPConnection }] = await Promise.all([
+    const [{ connectToActual }, { ActualMCPConnection }] = await Promise.all([
         import('./actualConnection.js'),
-        import('./tests/actualToolsTests.js'),
         import('./lib/ActualMCPConnection.js'),
     ]);
     const [{ startHttpServer }, { startStdioServer }, loggerModule, osModule, utilsModule, actualToolsManagerModule,] = await Promise.all([
@@ -153,12 +165,10 @@ if (argsEarly.includes('--help')) {
     const useHttp = args.includes('--http');
     const useStdio = args.includes('--stdio');
     const useTestActualConnection = args.includes('--test-actual-connection');
-    const useTestActualTools = args.includes('--test-actual-tools');
     const useTestMcpClient = args.includes('--test-mcp-client');
     const SERVER_DESCRIPTION = 'Bridge MCP server exposing Actual finance API to LibreChat.';
     const SERVER_INSTRUCTIONS = 'Welcome to the Actual MCP server. The tools listed here are only the ones currently confirmed and tested, ' +
         'but the server can proxy any API call supported by Actual. As we expand coverage, more tools will be officially exposed.';
-    const usage = usageEarly;
     async function main() {
         // Mutual exclusion — stdio and http are incompatible transports
         if (useHttp && useStdio) {
@@ -175,23 +185,6 @@ if (argsEarly.includes('--help')) {
             logger.info('⚙️  --test-actual-connection specified, connection to Actual Finance successful.');
             process.exit(0);
         }
-        if (useTestActualTools) {
-            logger.info('⚙️  --test-actual-tools specified, connecting and testing all tools...');
-            try {
-                await testAllTools();
-                logger.info('✅ All tool tests completed.');
-            }
-            catch (err) {
-                if (err instanceof Error) {
-                    logger.error('❌ Tool tests failed: %s', err.message);
-                }
-                else {
-                    logger.error('❌ Tool tests failed: %o', err);
-                }
-                process.exit(1);
-            }
-            process.exit(0);
-        }
         // Initialize tools before usage
         await actualToolsManager.initialize();
         // Now get implemented tools after initialization

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.5.1",
+  "version": "0.5.4",
+  "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",

package/dist/src/tests/actualToolsTests.js

@@ -1,70 +0,0 @@
-// src/tests/actualToolsTests.ts
-import logger from '../logger.js';
-import actualToolsManager from '../actualToolsManager.js';
-// Test data mapping for each tool
-const getTestArgs = (toolName) => {
-    switch (toolName) {
-        case 'actual.accounts.create':
-            return { name: 'Test Account', balance: 1000 };
-        case 'actual.accounts.update':
-            return { id: 'test-account-id', fields: { name: 'Updated Test Account' } };
-        case 'actual.accounts.get.balance':
-            return { id: 'test-account-id' };
-        case 'actual.transactions.create':
-            return { accountId: 'test-account-id', amount: 100, payee: 'Test Payee', date: '2025-11-08' };
-        case 'actual.transactions.get':
-            return { accountId: 'test-account-id', startDate: '2025-11-01', endDate: '2025-11-08' };
-        case 'actual.transactions.import':
-            return { accountId: 'test-account-id', txs: [{ amount: 50, payee: 'Import Test', date: '2025-11-08' }] };
-        case 'actual.categories.create':
-            // Try different field names that might be expected
-            return { name: 'Test Category', group_id: 'fc3825fd-b982-4b72-b768-5b30844cf832', groupId: 'fc3825fd-b982-4b72-b768-5b30844cf832' };
-        case 'actual.payees.create':
-            return { name: 'Test Payee' };
-        case 'actual.budgets.setAmount':
-            // Use an existing category ID (Food category from the budget data)
-            return { month: '2025-11', categoryId: '541836f1-e756-4473-a5d0-6c1d3f06c7fa', amount: 500 };
-        case 'actual.budgets.getMonth':
-            return { month: '2025-11' };
-        // These tools don't require parameters
-        case 'actual.accounts.list':
-        case 'actual.categories.get':
-        case 'actual.payees.get':
-        case 'actual.budgets.getMonths':
-        default:
-            return {};
-    }
-};
-export async function testAllTools() {
-    await actualToolsManager.initialize();
-    const toolNames = actualToolsManager.getToolNames();
-    const results = [];
-    for (const name of toolNames) {
-        try {
-            logger.info(`⚙️  Testing tool: ${name}`);
-            const testArgs = getTestArgs(name);
-            const result = await actualToolsManager.callTool(name, testArgs);
-            logger.info(`✅ Tool ${name} output: ${JSON.stringify(result, null, 2)}`);
-            results.push({ name, success: true });
-        }
-        catch (err) {
-            const message = err && typeof err?.message === 'string' ? err.message : String(err);
-            logger.error(`❌ Tool ${name} test failed: ${message}`);
-            results.push({ name, success: false, error: message });
-        }
-    }
-    // Summary
-    const successful = results.filter(r => r.success).length;
-    const failed = results.filter(r => !r.success).length;
-    logger.info(`\n📊 Test Summary: ${successful} passed, ${failed} failed`);
-    if (failed > 0) {
-        logger.error(`❌ Failed tools:`);
-        results.filter(r => !r.success).forEach(r => {
-            logger.error(`  - ${r.name}: ${r.error}`);
-        });
-        throw new Error(`${failed} tool tests failed`);
-    }
-    else {
-        logger.info(`🎉 All ${successful} tools passed!`);
-    }
-}