mcp-grocy 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -1,15 +1,29 @@
-# [2.5.0](https://github.com/miguelangel-nubla/mcp-grocy/compare/v2.4.4...v2.5.0) (2026-03-30)
-
+# [2.6.0](https://github.com/miguelangel-nubla/mcp-grocy/compare/v2.5.0...v2.6.0) (2026-07-06)
 
 ### Bug Fixes
 
-* add read permissions for contents in release workflow to support nested publish-docker job ([5a055a6](https://github.com/miguelangel-nubla/mcp-grocy/commit/5a055a62cf07fa3f0f03d4319e485350c111804a))
-* improve test build isolation and commit-specific tagging ([b1875cc](https://github.com/miguelangel-nubla/mcp-grocy/commit/b1875ccc080111c6d56700aab9c493e418d155be))
+- reap idle streamable HTTP sessions to prevent McpServer leak ([c55b2c4](https://github.com/miguelangel-nubla/mcp-grocy/commit/c55b2c4808dac4ac5f0c55a45936c8f995d5efc3))
+
+### Features
+
+- add shopping_list_update_item tool to allow modifying list items ([dcbc974](https://github.com/miguelangel-nubla/mcp-grocy/commit/dcbc9746630667bbe89330bab7f7e9f84a3f060f))
+- add shopping*lists*\* configurations to example yaml ([204f03d](https://github.com/miguelangel-nubla/mcp-grocy/commit/204f03dca8c9ca17f3cfc476274f0a5b844912c7))
+- configure husky git hooks ([c8ac158](https://github.com/miguelangel-nubla/mcp-grocy/commit/c8ac1582f477c6dc074166b5a9753a06608c8007))
+- enhance shopping list tools with manual item support and enriched metadata resolution ([a1a8ce3](https://github.com/miguelangel-nubla/mcp-grocy/commit/a1a8ce341b61e5b24a366ae74a95a2c92e93e07c))
+- enrich shopping list tool responses with product and quantity unit details ([56bd553](https://github.com/miguelangel-nubla/mcp-grocy/commit/56bd553e17d913db1f2c61fc963a900f6477f45f))
+- expand shopping module with get, update, and filtered list capabilities ([d7e0e5d](https://github.com/miguelangel-nubla/mcp-grocy/commit/d7e0e5d94962c1b4daf0835a91fc275c25188673))
+- make productId optional in shopping list add tool ([a427e18](https://github.com/miguelangel-nubla/mcp-grocy/commit/a427e1832a9b70e579dae062c7665ec472656359))
+
+# [2.5.0](https://github.com/miguelangel-nubla/mcp-grocy/compare/v2.4.4...v2.5.0) (2026-03-30)
+
+### Bug Fixes
 
+- add read permissions for contents in release workflow to support nested publish-docker job ([5a055a6](https://github.com/miguelangel-nubla/mcp-grocy/commit/5a055a62cf07fa3f0f03d4319e485350c111804a))
+- improve test build isolation and commit-specific tagging ([b1875cc](https://github.com/miguelangel-nubla/mcp-grocy/commit/b1875ccc080111c6d56700aab9c493e418d155be))
 
 ### Features
 
-* improve tool call error handling, and implement multi-server shutdown management ([4d19cfb](https://github.com/miguelangel-nubla/mcp-grocy/commit/4d19cfb35dc238a41a92d2fba505998b6a59e1ae))
+- improve tool call error handling, and implement multi-server shutdown management ([4d19cfb](https://github.com/miguelangel-nubla/mcp-grocy/commit/4d19cfb35dc238a41a92d2fba505998b6a59e1ae))
 
 # Changelog
 

package/README.md

@@ -228,6 +228,19 @@ npm start
 - Increase `REST_RESPONSE_SIZE_LIMIT` if you have many products/stock entries
 - Consider disabling unused tools in `mcp-grocy.yaml`
 
+**High memory usage / RAM grows over time (HTTP mode)**
+
+- In HTTP mode the server automatically reaps idle MCP sessions (by default, after
+  5 minutes with no requests), so clients that disconnect without `DELETE /mcp` —
+  or that repeatedly reconnect with a new session — no longer leak per-session
+  server instances. No action is required.
+- Tune via `MCP_SESSION_IDLE_TIMEOUT_MS` / `MCP_SESSION_SWEEP_INTERVAL_MS` (or the
+  `server.session_idle_timeout_ms` / `server.session_sweep_interval_ms` YAML keys):
+  lower the timeout on memory-constrained hosts, raise it if a client legitimately
+  idles for long periods between calls.
+- For the lowest overhead, prefer an MCP client that reuses its `Mcp-Session-Id`
+  across requests and sends `DELETE /mcp` when it disconnects.
+
 #### Debug Mode
 
 Enable detailed logging and use the MCP inspector:

package/build/resources/CHANGELOG.md

@@ -1,15 +1,31 @@
-# [2.5.0](https://github.com/miguelangel-nubla/mcp-grocy/compare/v2.4.4...v2.5.0) (2026-03-30)
+# [2.6.0](https://github.com/miguelangel-nubla/mcp-grocy/compare/v2.5.0...v2.6.0) (2026-07-06)
 
 
 ### Bug Fixes
 
-* add read permissions for contents in release workflow to support nested publish-docker job ([5a055a6](https://github.com/miguelangel-nubla/mcp-grocy/commit/5a055a62cf07fa3f0f03d4319e485350c111804a))
-* improve test build isolation and commit-specific tagging ([b1875cc](https://github.com/miguelangel-nubla/mcp-grocy/commit/b1875ccc080111c6d56700aab9c493e418d155be))
+* reap idle streamable HTTP sessions to prevent McpServer leak ([c55b2c4](https://github.com/miguelangel-nubla/mcp-grocy/commit/c55b2c4808dac4ac5f0c55a45936c8f995d5efc3))
+
+
+### Features
+
+* add shopping_list_update_item tool to allow modifying list items ([dcbc974](https://github.com/miguelangel-nubla/mcp-grocy/commit/dcbc9746630667bbe89330bab7f7e9f84a3f060f))
+* add shopping_lists_* configurations to example yaml ([204f03d](https://github.com/miguelangel-nubla/mcp-grocy/commit/204f03dca8c9ca17f3cfc476274f0a5b844912c7))
+* configure husky git hooks ([c8ac158](https://github.com/miguelangel-nubla/mcp-grocy/commit/c8ac1582f477c6dc074166b5a9753a06608c8007))
+* enhance shopping list tools with manual item support and enriched metadata resolution ([a1a8ce3](https://github.com/miguelangel-nubla/mcp-grocy/commit/a1a8ce341b61e5b24a366ae74a95a2c92e93e07c))
+* enrich shopping list tool responses with product and quantity unit details ([56bd553](https://github.com/miguelangel-nubla/mcp-grocy/commit/56bd553e17d913db1f2c61fc963a900f6477f45f))
+* expand shopping module with get, update, and filtered list capabilities ([d7e0e5d](https://github.com/miguelangel-nubla/mcp-grocy/commit/d7e0e5d94962c1b4daf0835a91fc275c25188673))
+* make productId optional in shopping list add tool ([a427e18](https://github.com/miguelangel-nubla/mcp-grocy/commit/a427e1832a9b70e579dae062c7665ec472656359))
+
+# [2.5.0](https://github.com/miguelangel-nubla/mcp-grocy/compare/v2.4.4...v2.5.0) (2026-03-30)
+
+### Bug Fixes
 
+- add read permissions for contents in release workflow to support nested publish-docker job ([5a055a6](https://github.com/miguelangel-nubla/mcp-grocy/commit/5a055a62cf07fa3f0f03d4319e485350c111804a))
+- improve test build isolation and commit-specific tagging ([b1875cc](https://github.com/miguelangel-nubla/mcp-grocy/commit/b1875ccc080111c6d56700aab9c493e418d155be))
 
 ### Features
 
-* improve tool call error handling, and implement multi-server shutdown management ([4d19cfb](https://github.com/miguelangel-nubla/mcp-grocy/commit/4d19cfb35dc238a41a92d2fba505998b6a59e1ae))
+- improve tool call error handling, and implement multi-server shutdown management ([4d19cfb](https://github.com/miguelangel-nubla/mcp-grocy/commit/4d19cfb35dc238a41a92d2fba505998b6a59e1ae))
 
 # Changelog
 

package/build/resources/README.md

@@ -228,6 +228,19 @@ npm start
 - Increase `REST_RESPONSE_SIZE_LIMIT` if you have many products/stock entries
 - Consider disabling unused tools in `mcp-grocy.yaml`
 
+**High memory usage / RAM grows over time (HTTP mode)**
+
+- In HTTP mode the server automatically reaps idle MCP sessions (by default, after
+  5 minutes with no requests), so clients that disconnect without `DELETE /mcp` —
+  or that repeatedly reconnect with a new session — no longer leak per-session
+  server instances. No action is required.
+- Tune via `MCP_SESSION_IDLE_TIMEOUT_MS` / `MCP_SESSION_SWEEP_INTERVAL_MS` (or the
+  `server.session_idle_timeout_ms` / `server.session_sweep_interval_ms` YAML keys):
+  lower the timeout on memory-constrained hosts, raise it if a client legitimately
+  idles for long periods between calls.
+- For the lowest overhead, prefer an MCP client that reuses its `Mcp-Session-Id`
+  across requests and sends `DELETE /mcp` when it disconnects.
+
 #### Debug Mode
 
 Enable detailed logging and use the MCP inspector:

package/build/resources/config.md

@@ -22,10 +22,14 @@ Advanced configuration reference for the **mcp-grocy** npm package (this MCP ser
 
 Enable HTTP/SSE transport for web-based access:
 
-| Variable             | Description               | Default | Example |
-| -------------------- | ------------------------- | ------- | ------- |
-| `ENABLE_HTTP_SERVER` | Enable HTTP/SSE transport | `false` | `true`  |
-| `HTTP_SERVER_PORT`   | HTTP server port          | `8080`  | `3000`  |
+| Variable                        | Description                                          | Default  | Example  |
+| ------------------------------- | ---------------------------------------------------- | -------- | -------- |
+| `ENABLE_HTTP_SERVER`            | Enable HTTP/SSE transport                            | `false`  | `true`   |
+| `HTTP_SERVER_PORT`              | HTTP server port                                     | `8080`   | `3000`   |
+| `MCP_SESSION_IDLE_TIMEOUT_MS`   | Reap an idle MCP session after this many ms          | `300000` | `600000` |
+| `MCP_SESSION_SWEEP_INTERVAL_MS` | How often, in ms, to sweep for idle sessions to reap | `60000`  | `30000`  |
+
+The matching YAML keys are `server.session_idle_timeout_ms` and `server.session_sweep_interval_ms`.
 
 ### Transport Modes
 
@@ -33,6 +37,17 @@ Enable HTTP/SSE transport for web-based access:
 - **HTTP** - Streamable HTTP for web applications (`POST /mcp`)
 - **SSE** - Server-Sent Events for real-time web clients (`GET /mcp/sse`)
 
+### Session Reaping (HTTP mode)
+
+In HTTP mode the server keeps a transport and per-session MCP server instance for
+each session. Clients that disconnect without sending `DELETE /mcp`, or that
+reconnect with a new session id, would otherwise leave those instances in memory.
+The server reaps any session with no requests for `MCP_SESSION_IDLE_TIMEOUT_MS`,
+freeing its resources. A reaped client transparently re-initializes on its next
+request, so the default of 5 minutes is safe for normal use; lower it on
+memory-constrained hosts or raise it if a client legitimately idles for long
+periods between calls.
+
 ## 🛠️ Tool Configuration
 
 Tools are configured using the YAML configuration file `mcp-grocy.yaml`.

package/build/resources/response-format.md

@@ -102,7 +102,10 @@ These values can be set in your `.env` file for local development or in your pro
 
 ## Specialized Grocy Tools Response Format
 
-Tools like `inventory_stock_get_all`, `inventory_products_get`, `shopping_list_add_item`, etc., return the Grocy API response as MCP text content (usually stringified JSON).
+Tools like `inventory_stock_get_all`, `inventory_products_get`, `shopping_list_add_item`, etc., return successful Grocy API responses as structured MCP tool output:
+
+- `structuredContent.data`: the parsed Grocy response.
+- `content`: short human-readable status text.
 
 Example shape for a product-related read (illustrative):
 
@@ -111,14 +114,15 @@ Example shape for a product-related read (illustrative):
   "content": [
     {
       "type": "text",
-      "text": "{\n  \"id\": \"1\",\n  \"name\": \"Cookies\",\n  \"description\": null,\n  \"product_group_id\": \"1\",\n  \"qu_id_purchase\": \"2\",\n  \"qu_id_stock\": \"2\",\n  \"qu_factor_purchase_to_stock\": \"1.0\",\n  \"barcode\": null,\n  \"min_stock_amount\": \"0\",\n  \"default_best_before_days\": \"0\",\n  \"default_best_before_days_after_open\": \"0\",\n  \"default_best_before_days_after_freezing\": \"0\",\n  \"default_best_before_days_after_thawing\": \"0\",\n  \"picture_file_name\": null,\n  \"allow_partial_units_in_stock\": \"0\",\n  \"row_created_timestamp\": \"2023-01-01 10:00:00\",\n  \"show_in_recipes_list\": \"1\",\n  \"has_sub_products\": \"0\",\n  \"active\": \"1\",\n  \"calories\": null,\n  \"cumulate_min_stock_amount_of_sub_products\": \"0\",\n  \"due_type\": \"1\",\n  \"quick_consume_amount\": \"1.0\",\n  \"hide_on_stock_overview\": \"0\",\n  \"default_stock_label_type\": \"0\",\n  \"should_not_be_frozen\": \"0\",\n  \"treat_opened_as_out_of_stock\": \"1\",
-  \"no_own_stock\": \"0\",
-  \"default_consume_location_id\": null,
-  \"move_on_open\": \"0\",
-  \"userfields\": null
-}"
+      "text": "Product retrieved successfully"
     }
-  ]
+  ],
+  "structuredContent": {
+    "data": {
+      "id": "1",
+      "name": "Cookies"
+    }
+  }
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-grocy",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Model Context Protocol (MCP) server for Grocy integration",
   "license": "MIT",
   "type": "module",
@@ -20,7 +20,7 @@
   "scripts": {
     "prebuild": "node scripts/build.js",
     "build": "tsc",
-    "prepare": "npm run build",
+    "prepare": "husky",
     "start": "node build/main.js",
     "dev": "npm run build && node build/main.js",
     "watch": "tsc --watch",
@@ -71,6 +71,8 @@
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "fs-extra": "^11.3.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.8",
     "prettier": "^3.8.1",
     "semantic-release": "^25.0.3",
     "ts-node": "^10.9.1",
@@ -103,5 +105,14 @@
   },
   "config": {
     "supportedGrocyVersion": "4.5.0"
+  },
+  "lint-staged": {
+    "*.{ts,js,mjs,cjs}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,yaml,yml,md}": [
+      "prettier --write"
+    ]
   }
 }

package/build/api/client.js

@@ -1,119 +0,0 @@
-/**
- * Simplified API client for Grocy
- */
-import axios from 'axios';
-import https from 'https';
-import { config } from '../config/index.js';
-import { logger } from '../utils/logger.js';
-import { ApiError, ErrorHandler } from '../utils/errors.js';
-export class GrocyApiClient {
-    axiosInstance;
-    constructor() {
-        this.axiosInstance = this.createAxiosInstance();
-        this.setupInterceptors();
-    }
-    createAxiosInstance() {
-        const instance = axios.create({
-            baseURL: config.grocy.base_url,
-            validateStatus: () => true, // Handle all status codes manually
-            timeout: 30000,
-            maxContentLength: config.grocy.max_response_bytes,
-            httpsAgent: config.grocy.enable_ssl_verify
-                ? undefined
-                : new https.Agent({
-                    rejectUnauthorized: false,
-                }),
-        });
-        return instance;
-    }
-    setupInterceptors() {
-        // Request logging
-        this.axiosInstance.interceptors.request.use((config) => {
-            logger.api(`${config.method?.toUpperCase()} ${config.url}`);
-            return config;
-        }, (error) => {
-            logger.error('Request error', 'API', { error: error.message });
-            return Promise.reject(error);
-        });
-        // Response logging
-        this.axiosInstance.interceptors.response.use((response) => {
-            if (response.status >= 400) {
-                logger.warn(`HTTP ${response.status}`, 'API', {
-                    url: response.config?.url,
-                    status: response.status,
-                });
-            }
-            return response;
-        }, (error) => {
-            logger.error('Response error', 'API', { error: error.message });
-            return Promise.reject(error);
-        });
-    }
-    normalizeEndpoint(endpoint) {
-        if (endpoint.startsWith('/api/'))
-            return endpoint;
-        if (endpoint.startsWith('api/'))
-            return `/${endpoint}`;
-        if (endpoint.startsWith('/'))
-            return `/api${endpoint}`;
-        return `/api/${endpoint}`;
-    }
-    buildQueryString(params) {
-        return Object.entries(params)
-            .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
-            .join('&');
-    }
-    async request(endpoint, options = {}) {
-        const { method = 'GET', body = null, headers = {}, queryParams = {}, timeout } = options;
-        return ErrorHandler.handleAsync(async () => {
-            let url = this.normalizeEndpoint(endpoint);
-            if (Object.keys(queryParams).length > 0) {
-                url += `?${this.buildQueryString(queryParams)}`;
-            }
-            const requestConfig = {
-                method,
-                url,
-                headers: {
-                    Accept: 'application/json',
-                    'Content-Type': 'application/json',
-                    ...config.getCustomHeaders(),
-                    ...headers,
-                },
-                ...(timeout && { timeout }),
-            };
-            if (['POST', 'PUT', 'PATCH'].includes(method) && body !== null) {
-                requestConfig.data = body;
-            }
-            const response = await this.axiosInstance.request(requestConfig);
-            if (response.status >= 400) {
-                throw new ApiError(response.data?.message || `HTTP ${response.status} error`, response.status, `${method} ${url}`, { responseData: response.data });
-            }
-            return {
-                data: response.data,
-                status: response.status,
-                headers: response.headers,
-            };
-        }, `API ${method} ${endpoint}`);
-    }
-    // Convenience methods
-    async get(endpoint, options = {}) {
-        return this.request(endpoint, { ...options, method: 'GET' });
-    }
-    async post(endpoint, body, options = {}) {
-        return this.request(endpoint, { ...options, method: 'POST', body });
-    }
-    async put(endpoint, body, options = {}) {
-        return this.request(endpoint, { ...options, method: 'PUT', body });
-    }
-    async delete(endpoint, options = {}) {
-        return this.request(endpoint, { ...options, method: 'DELETE' });
-    }
-    async patch(endpoint, body, options = {}) {
-        return this.request(endpoint, { ...options, method: 'PATCH', body });
-    }
-}
-// Export singleton instance
-export const apiClient = new GrocyApiClient();
-export default apiClient;
-// Re-export ApiError for convenience
-export { ApiError };

package/build/config/index.js

@@ -1,259 +0,0 @@
-/**
- * Unified configuration system
- * Combines environment variables and YAML configuration
- */
-import { z } from 'zod';
-import { readFileSync, existsSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import YAML from 'yaml';
-import { logger } from '../utils/logger.js';
-const __dirname = dirname(fileURLToPath(import.meta.url));
-/** Default cap for Grocy HTTP response bodies (axios maxContentLength), in bytes */
-export const DEFAULT_MAX_RESPONSE_BYTES = 52_428_800; // 50 MiB
-// Environment schema
-const EnvironmentSchema = z.object({
-    // Grocy Configuration
-    GROCY_BASE_URL: z.string().url().optional(),
-    GROCY_API_KEY: z.string().optional(),
-    GROCY_ENABLE_SSL_VERIFY: z.enum(['true', 'false']).optional(),
-    GROCY_MAX_RESPONSE_BYTES: z.string().regex(/^\d+$/).optional(),
-    // Server Configuration
-    REST_RESPONSE_SIZE_LIMIT: z.string().regex(/^\d+$/).optional(),
-    ENABLE_HTTP_SERVER: z.enum(['true', 'false']).optional(),
-    HTTP_SERVER_PORT: z.string().regex(/^\d+$/).optional(),
-    HTTP_CORS_ORIGIN: z.string().optional(),
-    MCP_HTTP_ACCESS_TOKEN: z.string().optional(),
-    // Logging Configuration
-    LOG_LEVEL: z.enum(['DEBUG', 'INFO', 'WARN', 'ERROR']).optional(),
-    LOG_CATEGORIES: z.string().optional(),
-    // Build Configuration
-    RELEASE_VERSION: z.string().optional(),
-    NODE_ENV: z.enum(['development', 'production', 'test']).optional(),
-});
-// YAML configuration schema
-const YamlConfigSchema = z
-    .object({
-    server: z
-        .object({
-        enable_http_server: z.boolean().default(false),
-        http_server_port: z.number().min(1).max(65535).default(8080),
-        /** CORS `Access-Control-Allow-Origin` for HTTP MCP endpoints (`*` or a single origin URL) */
-        http_cors_origin: z.string().min(1).default('*'),
-        /** When set, MCP HTTP/SSE routes require `Authorization: Bearer <token>`, `X-MCP-Access-Token`, or `access_token` query (GET only). */
-        http_access_token: z.string().optional(),
-    })
-        .strict()
-        .default({
-        enable_http_server: false,
-        http_server_port: 8080,
-        http_cors_origin: '*',
-    }),
-    grocy: z
-        .object({
-        base_url: z.string().url().default('http://localhost:9283'),
-        api_key: z.string().optional(),
-        enable_ssl_verify: z.boolean().default(true),
-        response_size_limit: z.number().positive().default(10000),
-        /** Max Grocy API response body size in bytes (all tools); larger responses fail fast */
-        max_response_bytes: z.number().positive().default(DEFAULT_MAX_RESPONSE_BYTES),
-    })
-        .strict()
-        .default({
-        base_url: 'http://localhost:9283',
-        enable_ssl_verify: true,
-        response_size_limit: 10000,
-        max_response_bytes: DEFAULT_MAX_RESPONSE_BYTES,
-    }),
-    tools: z
-        .record(z.string(), z
-        .object({
-        enabled: z.boolean().default(false),
-        ack_token: z.string().optional(),
-    })
-        .catchall(z.unknown()))
-        .default({}),
-})
-    .strict();
-export class ConfigManager {
-    static instance;
-    config;
-    // Unified config properties - final resolved values
-    grocy;
-    server;
-    tools;
-    constructor(configPath) {
-        this.config = this.loadConfig(configPath);
-        // Expose final resolved values
-        this.grocy = {
-            base_url: this.config.yaml.grocy.base_url,
-            ...(this.config.yaml.grocy.api_key !== undefined && {
-                api_key: this.config.yaml.grocy.api_key,
-            }),
-            enable_ssl_verify: this.config.yaml.grocy.enable_ssl_verify,
-            response_size_limit: this.config.yaml.grocy.response_size_limit,
-            max_response_bytes: this.config.yaml.grocy.max_response_bytes,
-        };
-        this.server = {
-            enable_http_server: this.config.yaml.server.enable_http_server,
-            http_server_port: this.config.yaml.server.http_server_port,
-            http_cors_origin: this.config.yaml.server.http_cors_origin,
-            ...(this.config.yaml.server.http_access_token !== undefined &&
-                this.config.yaml.server.http_access_token !== '' && {
-                http_access_token: this.config.yaml.server.http_access_token,
-            }),
-        };
-        this.tools = this.config.yaml.tools;
-    }
-    static getInstance() {
-        if (!ConfigManager.instance) {
-            ConfigManager.instance = new ConfigManager();
-        }
-        return ConfigManager.instance;
-    }
-    loadConfig(configPath) {
-        // Load environment variables
-        const env = this.loadEnvironment();
-        // Load YAML configuration
-        const yaml = this.loadYamlConfig(configPath);
-        // Apply environment variable overrides
-        this.applyEnvironmentOverrides(yaml, env);
-        return { env, yaml };
-    }
-    loadEnvironment() {
-        try {
-            return EnvironmentSchema.parse(process.env);
-        }
-        catch (error) {
-            if (error instanceof z.ZodError) {
-                logger.error('Invalid environment variables', 'CONFIG');
-                for (const issue of error.issues) {
-                    const path = issue.path?.length ? issue.path.join('.') : '(root)';
-                    logger.error(`${path}: ${issue.message}`, 'CONFIG');
-                }
-                process.exit(1);
-            }
-            throw error;
-        }
-    }
-    loadYamlConfig(configPath) {
-        const yamlPath = this.findConfigFile(configPath);
-        try {
-            let configData = {};
-            if (existsSync(yamlPath)) {
-                const yamlContent = readFileSync(yamlPath, 'utf8');
-                configData = YAML.parse(yamlContent) || {};
-                logger.config(`Loaded YAML config from: ${yamlPath}`);
-            }
-            else {
-                logger.config('No YAML config found, using defaults');
-            }
-            return YamlConfigSchema.parse(configData);
-        }
-        catch (error) {
-            if (error instanceof z.ZodError) {
-                logger.error('Invalid YAML configuration', 'CONFIG');
-                for (const issue of error.issues) {
-                    const path = issue.path?.length ? issue.path.join('.') : '(root)';
-                    logger.error(`${path}: ${issue.message}`, 'CONFIG');
-                }
-                process.exit(1);
-            }
-            throw error;
-        }
-    }
-    findConfigFile(configPath) {
-        if (configPath)
-            return configPath;
-        // Look for config files in the following order:
-        // 1. Current working directory (for development)
-        // 2. Project root (relative to the compiled main.js)
-        const projectRoot = resolve(__dirname, '../..');
-        const possiblePaths = [
-            resolve(process.cwd(), 'mcp-grocy.yaml'),
-            resolve(process.cwd(), 'mcp-grocy.yml'),
-            resolve(projectRoot, 'mcp-grocy.yaml'),
-            resolve(projectRoot, 'mcp-grocy.yml'),
-        ];
-        return possiblePaths.find((path) => existsSync(path)) ?? possiblePaths[0];
-    }
-    // Public getters
-    getConfig() {
-        return this.config;
-    }
-    getApiUrl() {
-        return this.grocy.base_url.endsWith('/')
-            ? `${this.grocy.base_url}api`
-            : `${this.grocy.base_url}/api`;
-    }
-    getCustomHeaders() {
-        const headers = {};
-        if (this.grocy.api_key) {
-            headers['GROCY-API-KEY'] = this.grocy.api_key;
-        }
-        return headers;
-    }
-    /**
-     * Apply environment variable overrides to YAML configuration
-     */
-    applyEnvironmentOverrides(yaml, env) {
-        // Grocy configuration overrides
-        if (env.GROCY_BASE_URL) {
-            yaml.grocy.base_url = env.GROCY_BASE_URL;
-        }
-        if (env.GROCY_API_KEY) {
-            yaml.grocy.api_key = env.GROCY_API_KEY;
-        }
-        if (env.GROCY_ENABLE_SSL_VERIFY !== undefined) {
-            yaml.grocy.enable_ssl_verify = env.GROCY_ENABLE_SSL_VERIFY === 'true';
-        }
-        if (env.REST_RESPONSE_SIZE_LIMIT !== undefined) {
-            yaml.grocy.response_size_limit = parseInt(env.REST_RESPONSE_SIZE_LIMIT, 10);
-        }
-        if (env.GROCY_MAX_RESPONSE_BYTES !== undefined) {
-            yaml.grocy.max_response_bytes = parseInt(env.GROCY_MAX_RESPONSE_BYTES, 10);
-        }
-        // Server configuration overrides
-        if (env.ENABLE_HTTP_SERVER !== undefined) {
-            yaml.server.enable_http_server = env.ENABLE_HTTP_SERVER === 'true';
-        }
-        if (env.HTTP_SERVER_PORT !== undefined) {
-            yaml.server.http_server_port = parseInt(env.HTTP_SERVER_PORT, 10);
-        }
-        if (env.HTTP_CORS_ORIGIN !== undefined && env.HTTP_CORS_ORIGIN.length > 0) {
-            yaml.server.http_cors_origin = env.HTTP_CORS_ORIGIN;
-        }
-        if (env.MCP_HTTP_ACCESS_TOKEN !== undefined) {
-            yaml.server.http_access_token =
-                env.MCP_HTTP_ACCESS_TOKEN.length > 0 ? env.MCP_HTTP_ACCESS_TOKEN : undefined;
-        }
-    }
-    parseToolConfiguration() {
-        const enabledTools = new Set();
-        const toolSubConfigs = new Map();
-        const toolAckTokens = new Map();
-        for (const [toolName, toolConfig] of Object.entries(this.config.yaml.tools)) {
-            if (toolConfig.enabled) {
-                enabledTools.add(toolName);
-                // Store ack_token separately if configured
-                if (toolConfig.ack_token && typeof toolConfig.ack_token === 'string') {
-                    toolAckTokens.set(toolName, toolConfig.ack_token);
-                }
-                // Extract sub-configs (everything except standard fields)
-                const subConfigs = new Map();
-                for (const [key, value] of Object.entries(toolConfig)) {
-                    if (!['enabled', 'ack_token'].includes(key)) {
-                        subConfigs.set(key, value);
-                    }
-                }
-                if (subConfigs.size > 0) {
-                    toolSubConfigs.set(toolName, subConfigs);
-                }
-            }
-        }
-        return { enabledTools, toolSubConfigs, toolAckTokens };
-    }
-}
-// Export singleton instance
-export const config = ConfigManager.getInstance();
-export default config;

package/build/main.js

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-/**
- * Simplified main entry point
- * Demonstrates the refactored architecture
- */
-// Load environment variables
-import 'dotenv/config';
-import { GrocyMcpServer } from './server/mcp-server.js';
-import { config } from './config/index.js';
-import { VERSION, PACKAGE_NAME as SERVER_NAME } from './version.js';
-import { logger } from './utils/logger.js';
-import { ErrorHandler } from './utils/errors.js';
-// Startup banner
-logger.info(`Starting ${SERVER_NAME} v${VERSION}`, 'SERVER');
-async function main() {
-    return ErrorHandler.handleAsync(async () => {
-        // Check API key
-        if (!config.grocy.api_key) {
-            logger.warn('No API key configured. Some operations may fail.', 'CONFIG');
-        }
-        // Log configuration summary
-        logger.config(`Grocy URL: ${config.grocy.base_url}`);
-        logger.config(`SSL Verify: ${config.grocy.enable_ssl_verify}`);
-        logger.config(`HTTP Server: ${config.server.enable_http_server}`);
-        // Create and start server
-        const server = await GrocyMcpServer.create();
-        await server.start();
-        logger.info('Server started successfully', 'SERVER');
-    }, 'server startup');
-}
-// Error handling
-process.on('uncaughtException', (error) => {
-    logger.error('Uncaught exception', 'PROCESS', { error });
-    process.exit(1);
-});
-process.on('unhandledRejection', (reason, promise) => {
-    logger.error('Unhandled rejection', 'PROCESS', { reason, promise });
-    process.exit(1);
-});
-// Start the application
-main().catch((error) => {
-    logger.error('Failed to start server', 'SERVER', { error });
-    process.exit(1);
-});