@yamaru-eu/hardware-probe 1.0.3

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Yamaru Project Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,63 @@
+# Yamaru Hardware Probe (MCP)
+
+Official Model Context Protocol (MCP) server for hardware inventory and AI-assisted diagnostics. Part of the [Yamaru](https://www.yamaru.eu) ecosystem.
+
+## 📦 Official Repository
+The official standalone repository for this project is: [github.com/yamaru-eu/hardware-probe](https://github.com/yamaru-eu/hardware-probe).
+
+## 🚀 Quick Start (for Claude Desktop)
+
+Since this package is hosted on **GitHub Packages**, you may need to authenticate your local npm client first if you haven't already.
+
+### 1. Installation via npx
+Add this to your `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "yamaru-probe": {
+      "command": "npx",
+      "args": ["-y", "@yamaru-eu/hardware-probe"]
+    }
+  }
+}
+```
+
+### 2. Manual Installation
+If you prefer to install it globally:
+```bash
+# Create or edit ~/.npmrc to include the GitHub Packages registry
+echo "@yamaru-eu:registry=https://npm.pkg.github.com" >> ~/.npmrc
+
+# Install the probe
+npm install -g @yamaru-eu/hardware-probe
+
+# Then use 'yamaru-probe' as the command in your config
+```
+
+## Key Features
+
+- **Deep Hardware Analysis**: Reports CPU, GPU (VRAM), detailed RAM (slots), Storage (SSD/HDD/NVMe), and Displays (Resolution/Hz).
+- **Native Anonymization**: Automatically filters out serial numbers, UUIDs, and hostnames before sending data to the LLM.
+- **Performance Monitor**: Real-time analysis of CPU load, memory usage, and identification of the top 5 most resource-heavy processes.
+- **Compatibility Checker**: Test if the machine can run a specific software/game via the remote API.
+
+## Commands
+
+```bash
+npm install        # Install dependencies
+npm run build      # Compile TypeScript
+npm run dev        # Fast launch via tsx
+npm run inspector  # Launch the interactive MCP inspector
+npm run lint       # Type checking
+```
+
+## Exposed MCP Tools
+
+1. `analyze_local_system`: Returns a complete, anonymized hardware inventory.
+2. `analyze_performance`: Returns current system load and active processes.
+3. `check_software_compatibility`: Verifies compatibility with a given software (e.g., "Cyberpunk 2077").
+4. `get_hardware_recommendation`: Analyzes the system and suggests upgrades via the remote API.
+
+## Configuration
+
+- `REMOTE_API_URL`: Remote API URL (default: `http://localhost:3000`).

package/dist/api.client.d.ts

@@ -0,0 +1,29 @@
+import { SystemSpecs } from "./types.js";
+/**
+ * Client for interacting with the remote Yamaru API.
+ */
+export declare class ApiClient {
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    /**
+     * Generic fetch wrapper with timeout and error handling.
+     */
+    private post;
+    /**
+     * Checks compatibility for a specific software.
+     */
+    checkSoftwareCompatibility(specs: SystemSpecs, softwareName: string): Promise<unknown>;
+    /**
+     * Gets general hardware recommendations.
+     */
+    getHardwareRecommendation(specs: SystemSpecs, userQuery: string, budget: number): Promise<unknown>;
+    /**
+     * Checks compatibility for a specific LLM model.
+     */
+    checkLlmCompatibility(specs: SystemSpecs, modelName: string): Promise<unknown>;
+    /**
+     * Gets recommendations for local LLM models.
+     */
+    getLlmRecommendations(specs: SystemSpecs, useCase?: string, limit?: number): Promise<unknown>;
+}
+//# sourceMappingURL=api.client.d.ts.map

package/dist/api.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.client.d.ts","sourceRoot":"","sources":["../src/api.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAA4B;IAIjD;;OAEG;YACW,IAAI;IAyBlB;;OAEG;IACG,0BAA0B,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM;IAIzE;;OAEG;IACG,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIrF;;OAEG;IACG,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;IAIjE;;OAEG;IACG,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAGjF"}

package/dist/api.client.js

@@ -0,0 +1,60 @@
+import { CONFIG } from "./config.js";
+/**
+ * Client for interacting with the remote Yamaru API.
+ */
+export class ApiClient {
+    baseUrl;
+    constructor(baseUrl = CONFIG.remoteApiUrl) {
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Generic fetch wrapper with timeout and error handling.
+     */
+    async post(endpoint, body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!response.ok) {
+                const errorBody = await response.text().catch(() => "(no body)");
+                throw new Error(`API error (${response.status}): ${errorBody}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "TimeoutError") {
+                throw new Error(`API request timed out after 15s at ${url}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Checks compatibility for a specific software.
+     */
+    async checkSoftwareCompatibility(specs, softwareName) {
+        return this.post("/check-compatibility", { specs, software_name: softwareName });
+    }
+    /**
+     * Gets general hardware recommendations.
+     */
+    async getHardwareRecommendation(specs, userQuery, budget) {
+        return this.post("/recommend", { specs, user_query: userQuery, budget });
+    }
+    /**
+     * Checks compatibility for a specific LLM model.
+     */
+    async checkLlmCompatibility(specs, modelName) {
+        return this.post("/llm/check", { specs, model_name: modelName });
+    }
+    /**
+     * Gets recommendations for local LLM models.
+     */
+    async getLlmRecommendations(specs, useCase, limit) {
+        return this.post("/llm/recommend", { specs, use_case: useCase, limit });
+    }
+}
+//# sourceMappingURL=api.client.js.map

package/dist/api.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.client.js","sourceRoot":"","sources":["../src/api.client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,OAAO,SAAS;IACH,OAAO,CAAS;IAEjC,YAAY,UAAkB,MAAM,CAAC,YAAY;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,IAAI,CAAI,QAAgB,EAAE,IAAS;QAC/C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC5D,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,0BAA0B,CAAC,KAAkB,EAAE,YAAoB;QACvE,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,yBAAyB,CAAC,KAAkB,EAAE,SAAiB,EAAE,MAAc;QACnF,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAAkB,EAAE,SAAiB;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAAkB,EAAE,OAAgB,EAAE,KAAc;QAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.test.d.ts.map

package/dist/api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.test.d.ts","sourceRoot":"","sources":["../src/api.test.ts"],"names":[],"mappings":""}

package/dist/api.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { ApiClient } from "./api.client.js";
+describe("ApiClient", () => {
+    const mockBaseUrl = "http://api.test";
+    const client = new ApiClient(mockBaseUrl);
+    beforeEach(() => {
+        vi.stubGlobal('fetch', vi.fn());
+    });
+    it("should format software compatibility requests correctly", async () => {
+        const mockResponse = { status: "compatible" };
+        fetch.mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve(mockResponse)
+        });
+        const specs = { cpu: "test" };
+        const result = await client.checkSoftwareCompatibility(specs, "GameX");
+        expect(fetch).toHaveBeenCalledWith(expect.stringContaining("/check-compatibility"), expect.objectContaining({
+            method: "POST",
+            body: JSON.stringify({ specs, software_name: "GameX" })
+        }));
+        expect(result).toEqual(mockResponse);
+    });
+    it("should throw a meaningful error when API returns 500", async () => {
+        fetch.mockResolvedValue({
+            ok: false,
+            status: 500,
+            text: () => Promise.resolve("Internal Server Error")
+        });
+        await expect(client.checkSoftwareCompatibility({}, "X"))
+            .rejects.toThrow("API error (500): Internal Server Error");
+    });
+    it("should handle timeouts correctly", async () => {
+        const timeoutError = new Error("Timeout");
+        timeoutError.name = "TimeoutError";
+        fetch.mockRejectedValue(timeoutError);
+        await expect(client.getLlmRecommendations({}))
+            .rejects.toThrow(/request timed out/);
+    });
+});
+//# sourceMappingURL=api.test.js.map

package/dist/api.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.test.js","sourceRoot":"","sources":["../src/api.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,WAAW,GAAG,iBAAiB,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IAE1C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,YAAY,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAC7C,KAAa,CAAC,iBAAiB,CAAC;YAC/B,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;SAC1C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEvE,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,EAC/C,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;SACxD,CAAC,CACH,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACnE,KAAa,CAAC,iBAAiB,CAAC;YAC/B,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC;SACrD,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,EAAS,EAAE,GAAG,CAAC,CAAC;aAC5D,OAAO,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1C,YAAY,CAAC,IAAI,GAAG,cAAc,CAAC;QAClC,KAAa,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAE/C,MAAM,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAS,CAAC,CAAC;aAClD,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import { AppConfig } from "./types.js";
+/**
+ * Default configuration values.
+ * Uses environment variables with sensible fallbacks.
+ */
+export declare const CONFIG: AppConfig;
+/**
+ * Validates that the configuration is sane.
+ */
+export declare function validateConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,SAMpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,SAM7B"}

package/dist/config.js

@@ -0,0 +1,22 @@
+/**
+ * Default configuration values.
+ * Uses environment variables with sensible fallbacks.
+ */
+export const CONFIG = {
+    // Remote API URL, removing trailing slashes and the '/recommend' path if accidentally provided
+    remoteApiUrl: (process.env.REMOTE_API_URL || "http://localhost:3001/api").replace(/\/recommend\/?$/, "").replace(/\/$/, ""),
+    serverName: "yamaru-hardware-probe",
+    serverVersion: "1.0.1",
+};
+/**
+ * Validates that the configuration is sane.
+ */
+export function validateConfig() {
+    try {
+        new URL(CONFIG.remoteApiUrl);
+    }
+    catch (e) {
+        throw new Error(`Invalid REMOTE_API_URL: ${CONFIG.remoteApiUrl}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAc;IAC/B,+FAA+F;IAC/F,YAAY,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,2BAA2B,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAE3H,UAAU,EAAE,uBAAuB;IACnC,aAAa,EAAE,OAAO;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/hardware.service.d.ts

@@ -0,0 +1,23 @@
+import { SystemSpecs, PerformanceStatus } from "./types.js";
+/**
+ * Service for interacting with system hardware information.
+ */
+export declare class HardwareService {
+    /**
+     * Captures real-time performance metrics.
+     */
+    getPerformanceStatus(): Promise<PerformanceStatus>;
+    /**
+     * Retrieves full hardware specifications.
+     */
+    getLocalSpecs(): Promise<SystemSpecs>;
+    /**
+     * Retrieves specs and strips any Personally Identifiable Information (PII).
+     */
+    getAnonymizedSpecs(): Promise<SystemSpecs>;
+    /**
+     * Checks if the system is an Apple Silicon based machine.
+     */
+    isAppleSilicon(specs: SystemSpecs): boolean;
+}
+//# sourceMappingURL=hardware.service.d.ts.map

package/dist/hardware.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.service.d.ts","sourceRoot":"","sources":["../src/hardware.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiCxD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;IAwE3C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC;IAehD;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;CAM5C"}

package/dist/hardware.service.js

@@ -0,0 +1,136 @@
+import si from "systeminformation";
+/**
+ * Service for interacting with system hardware information.
+ */
+export class HardwareService {
+    /**
+     * Captures real-time performance metrics.
+     */
+    async getPerformanceStatus() {
+        const [load, mem, procs] = await Promise.all([
+            si.currentLoad(),
+            si.mem(),
+            si.processes(),
+        ]);
+        return {
+            cpuLoad: {
+                currentLoad: load.currentLoad,
+                currentLoadUser: load.currentLoadUser,
+                currentLoadSystem: load.currentLoadSystem,
+                rawCurrentLoad: load.rawCurrentLoad,
+            },
+            memoryUsage: {
+                total: mem.total,
+                used: mem.used,
+                active: mem.active,
+                available: mem.available,
+                swaptotal: mem.swaptotal,
+                swapused: mem.swapused,
+            },
+            topProcesses: procs.list
+                .sort((a, b) => b.cpu - a.cpu)
+                .slice(0, 5)
+                .map((p) => ({
+                name: p.name,
+                cpu: p.cpu,
+                mem: p.mem,
+            })),
+        };
+    }
+    /**
+     * Retrieves full hardware specifications.
+     */
+    async getLocalSpecs() {
+        const [cpu, mem, memLayout, graphics, disks, baseboard, osInfo] = await Promise.all([
+            si.cpu(),
+            si.mem(),
+            si.memLayout(),
+            si.graphics(),
+            si.diskLayout(),
+            si.baseboard(),
+            si.osInfo(),
+        ]);
+        return {
+            cpu: {
+                manufacturer: cpu.manufacturer,
+                brand: cpu.brand,
+                speed: cpu.speed,
+                cores: cpu.cores,
+                physicalCores: cpu.physicalCores,
+            },
+            memory: {
+                total: mem.total,
+                totalGb: (mem.total / 1024 ** 3).toFixed(1) + " GB",
+                free: mem.free,
+                used: mem.used,
+                layout: memLayout.map((m) => ({
+                    size: m.size,
+                    bank: m.bank,
+                    type: m.type,
+                    clockSpeed: m.clockSpeed,
+                    formFactor: m.formFactor,
+                })),
+            },
+            graphics: {
+                controllers: graphics.controllers.map((g) => ({
+                    model: g.model,
+                    vendor: g.vendor,
+                    vram: g.vram,
+                    bus: g.bus,
+                })),
+                displays: graphics.displays.map((d) => ({
+                    model: d.model,
+                    main: d.main,
+                    resolutionX: d.currentResX,
+                    resolutionY: d.currentResY,
+                    refreshRate: d.currentRefreshRate,
+                    sizeX: d.sizeX,
+                    sizeY: d.sizeY,
+                })),
+            },
+            storage: disks.map((d) => ({
+                type: d.type,
+                name: d.name,
+                vendor: d.vendor,
+                size: d.size,
+                interface: d.interfaceType,
+            })),
+            baseboard: {
+                manufacturer: baseboard.manufacturer,
+                model: baseboard.model,
+                version: baseboard.version,
+                memMax: baseboard.memMax ?? null,
+                memSlots: baseboard.memSlots ?? null,
+            },
+            os: {
+                platform: osInfo.platform,
+                distro: osInfo.distro,
+                release: osInfo.release,
+                arch: osInfo.arch,
+            },
+        };
+    }
+    /**
+     * Retrieves specs and strips any Personally Identifiable Information (PII).
+     */
+    async getAnonymizedSpecs() {
+        const specs = await this.getLocalSpecs();
+        // Explicit locale detection
+        const locale = Intl.DateTimeFormat().resolvedOptions().locale || 'en-US';
+        return {
+            ...specs,
+            os: {
+                ...specs.os,
+                locale
+            }
+        };
+    }
+    /**
+     * Checks if the system is an Apple Silicon based machine.
+     */
+    isAppleSilicon(specs) {
+        return (specs.cpu.manufacturer?.toLowerCase().includes('apple') ||
+            (specs.os.platform === 'darwin' && specs.os.arch === 'arm64'));
+    }
+}
+//# sourceMappingURL=hardware.service.js.map

package/dist/hardware.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.service.js","sourceRoot":"","sources":["../src/hardware.service.ts"],"names":[],"mappings":"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"}

package/dist/hardware.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hardware.test.d.ts.map

package/dist/hardware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.test.d.ts","sourceRoot":"","sources":["../src/hardware.test.ts"],"names":[],"mappings":""}

package/dist/hardware.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect, vi } from "vitest";
+import { HardwareService } from "./hardware.service.js";
+describe("HardwareService", () => {
+    const service = new HardwareService();
+    describe("isAppleSilicon", () => {
+        it("should return true for Apple manufacturer", () => {
+            const specs = {
+                cpu: { manufacturer: "Apple" },
+                os: { platform: "darwin", arch: "arm64" }
+            };
+            expect(service.isAppleSilicon(specs)).toBe(true);
+        });
+        it("should return true for Darwin ARM64 even if manufacturer is missing", () => {
+            const specs = {
+                cpu: { manufacturer: "" },
+                os: { platform: "darwin", arch: "arm64" }
+            };
+            expect(service.isAppleSilicon(specs)).toBe(true);
+        });
+        it("should return false for Intel machine", () => {
+            const specs = {
+                cpu: { manufacturer: "Intel" },
+                os: { platform: "win32", arch: "x64" }
+            };
+            expect(service.isAppleSilicon(specs)).toBe(false);
+        });
+    });
+    describe("getAnonymizedSpecs", () => {
+        it("should include a locale in the os specs", async () => {
+            // Mock getLocalSpecs to avoid calling real systeminfo
+            vi.spyOn(service, 'getLocalSpecs').mockResolvedValue({
+                os: { platform: 'linux', distro: 'Ubuntu', arch: 'x64' }
+            });
+            const anonymized = await service.getAnonymizedSpecs();
+            expect(anonymized.os.locale).toBeDefined();
+            expect(typeof anonymized.os.locale).toBe('string');
+        });
+    });
+});
+//# sourceMappingURL=hardware.test.js.map

package/dist/hardware.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.test.js","sourceRoot":"","sources":["../src/hardware.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;IAEtC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAQ;gBACjB,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;gBAC9B,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;aAC1C,CAAC;YACF,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,KAAK,GAAQ;gBACjB,GAAG,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;gBACzB,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;aAC1C,CAAC;YACF,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,KAAK,GAAQ;gBACjB,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;gBAC9B,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE;aACvC,CAAC;YACF,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,sDAAsD;YACtD,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,iBAAiB,CAAC;gBACnD,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;aAClD,CAAC,CAAC;YAEV,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;YACtD,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CONFIG, validateConfig } from "./config.js";
+import { HardwareService } from "./hardware.service.js";
+import { ApiClient } from "./api.client.js";
+// ---------------------------------------------------------------------------
+// Setup
+// ---------------------------------------------------------------------------
+validateConfig();
+const hardware = new HardwareService();
+const api = new ApiClient();
+const server = new Server({
+    name: CONFIG.serverName,
+    version: CONFIG.serverVersion,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ---------------------------------------------------------------------------
+// Tool Definitions
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "analyze_local_system",
+                description: "Reads the hardware specifications of the local machine: CPU, RAM, motherboard and OS. Returns a structured JSON object. No arguments required.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "analyze_performance",
+                description: "Provides real-time system performance: CPU load, memory usage, and the top 5 most demanding processes. Useful for identifying performance bottlenecks.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "check_software_compatibility",
+                description: "Checks if the local machine is compatible with a specific software or game. Analyzes CPU, GPU, RAM, and Storage requirements. Returns a compatibility report and upgrade suggestions.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        software_name: {
+                            type: "string",
+                            description: "The name of the software or game to check (e.g. 'Cyberpunk 2077', 'Adobe Premiere Pro').",
+                        },
+                    },
+                    required: ["software_name"],
+                },
+            },
+            {
+                name: "get_hardware_recommendation",
+                description: "Analyzes the local machine specs and sends them along with the user query and budget to the remote recommendation API. Returns a list of compatible hardware products with affiliate links.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        user_query: {
+                            type: "string",
+                            description: "What the user wants to upgrade or buy (e.g. 'I need more RAM for video editing').",
+                        },
+                        budget: {
+                            type: "number",
+                            description: "Maximum budget in euros (or local currency).",
+                        },
+                    },
+                    required: ["user_query", "budget"],
+                },
+            },
+            {
+                name: "check_llm_compatibility",
+                description: "Checks if a specific LLM model can run on this machine. Returns optimal quantization, estimated tokens per second, and execution mode (GPU, CPU+GPU, or CPU only).",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        model_name: {
+                            type: "string",
+                            description: "LLM model name (e.g., 'Llama 3.1 70B', 'Mixtral 8x7B', 'Qwen 2.5 Coder 32B')"
+                        }
+                    },
+                    required: ["model_name"]
+                }
+            },
+            {
+                name: "get_llm_recommendations",
+                description: "Recommends the best LLM models that can run locally on this machine, ranked by compatibility score. Can be filtered by use case: general, coding, reasoning, chat, or embedding.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        use_case: {
+                            type: "string",
+                            enum: ["general", "coding", "reasoning", "chat", "embedding", "multimodal"],
+                            description: "Use case to weight recommendations (default: general)"
+                        },
+                        limit: {
+                            type: "number",
+                            description: "Maximum number of recommendations (default: 5)"
+                        }
+                    }
+                }
+            },
+        ],
+    };
+});
+// ---------------------------------------------------------------------------
+// Tool Handlers
+// ---------------------------------------------------------------------------
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "analyze_local_system": {
+                const specs = await hardware.getLocalSpecs();
+                return { content: [{ type: "text", text: JSON.stringify(specs, null, 2) }] };
+            }
+            case "analyze_performance": {
+                const stats = await hardware.getPerformanceStatus();
+                return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
+            }
+            case "check_software_compatibility": {
+                const { software_name } = args;
+                if (!software_name)
+                    throw new Error("software_name is required");
+                const specs = await hardware.getLocalSpecs();
+                const data = await api.checkSoftwareCompatibility(specs, software_name);
+                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            }
+            case "get_hardware_recommendation": {
+                const { user_query, budget } = args;
+                if (!user_query || budget === undefined)
+                    throw new Error("user_query and budget are required");
+                const specs = await hardware.getLocalSpecs();
+                const data = await api.getHardwareRecommendation(specs, user_query, budget);
+                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            }
+            case "check_llm_compatibility": {
+                const { model_name } = args;
+                if (!model_name)
+                    throw new Error("model_name is required");
+                const specs = await hardware.getAnonymizedSpecs();
+                const data = await api.checkLlmCompatibility(specs, model_name);
+                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            }
+            case "get_llm_recommendations": {
+                const { use_case, limit } = args;
+                const specs = await hardware.getAnonymizedSpecs();
+                const data = await api.getLlmRecommendations(specs, use_case, limit);
+                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            }
+            default:
+                return {
+                    content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Lifecycle
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`${CONFIG.serverName} v${CONFIG.serverVersion} running on stdio\n`);
+}
+main().catch((error) => {
+    process.stderr.write(`Fatal error: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,cAAc,EAAE,CAAC;AAEjB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;AACvC,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;AAE5B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,MAAM,CAAC,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC,aAAa;CAC9B,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EACT,gJAAgJ;gBAClJ,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,wJAAwJ;gBAC1J,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;YACD;gBACE,IAAI,EAAE,8BAA8B;gBACpC,WAAW,EACT,uLAAuL;gBACzL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,aAAa,EAAE;4BACb,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0FAA0F;yBACxG;qBACF;oBACD,QAAQ,EAAE,CAAC,eAAe,CAAC;iBAC5B;aACF;YACD;gBACE,IAAI,EAAE,6BAA6B;gBACnC,WAAW,EACT,6LAA6L;gBAC/L,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,mFAAmF;yBACjG;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,8CAA8C;yBAC5D;qBACF;oBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;iBACnC;aACF;YACD;gBACE,IAAI,EAAE,yBAAyB;gBAC/B,WAAW,EAAE,oKAAoK;gBACjL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,8EAA8E;yBAC5F;qBACF;oBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;iBACzB;aACF;YACD;gBACE,IAAI,EAAE,yBAAyB;gBAC/B,WAAW,EAAE,kLAAkL;gBAC/L,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC;4BAC3E,WAAW,EAAE,uDAAuD;yBACrE;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gDAAgD;yBAC9D;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAA2B,EAAE;IACzF,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,sBAAsB,CAAC,CAAC,CAAC;gBAC5B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/E,CAAC;YAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,CAAC;gBACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/E,CAAC;YAED,KAAK,8BAA8B,CAAC,CAAC,CAAC;gBACpC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAiC,CAAC;gBAC5D,IAAI,CAAC,aAAa;oBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;gBAEjE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,0BAA0B,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;gBACxE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9E,CAAC;YAED,KAAK,6BAA6B,CAAC,CAAC,CAAC;gBACnC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAA8C,CAAC;gBAC9E,IAAI,CAAC,UAAU,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;gBAE/F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,yBAAyB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;gBAC5E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9E,CAAC;YAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;gBAC/B,MAAM,EAAE,UAAU,EAAE,GAAG,IAA8B,CAAC;gBACtD,IAAI,CAAC,UAAU;oBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;gBAE3D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9E,CAAC;YAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;gBAC/B,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAA6C,CAAC;gBAE1E,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9E,CAAC;YAED;gBACE,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;oBAC1D,OAAO,EAAE,IAAI;iBACd,CAAC;QACN,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YACtD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,aAAa,qBAAqB,CAAC,CAAC;AAC3F,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,20 @@
+import { describe, it, expect } from "vitest";
+describe("mcp-local-client", () => {
+    it("should have a basic sanity check", () => {
+        expect(true).toBe(true);
+    });
+});
+describe('LLM tools', () => {
+    it('check_llm_compatibility est listé dans les tools', () => {
+        // Conceptual test, server is not exported in index.ts
+        // In a real scenario we'd export the list of tools to test them
+        expect(true).toBe(true);
+    });
+    it('get_llm_recommendations est listé dans les tools', () => {
+        expect(true).toBe(true);
+    });
+    it('check_llm_compatibility retourne un résultat pour Llama 3.1 8B', () => {
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,sDAAsD;QACtD,gEAAgE;QAChE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Hardware specifications of the local machine.
+ */
+export interface SystemSpecs {
+    cpu: {
+        manufacturer: string;
+        brand: string;
+        speed: number;
+        cores: number;
+        physicalCores: number;
+    };
+    memory: {
+        total: number;
+        totalGb: string;
+        free: number;
+        used: number;
+        layout: Array<{
+            size: number;
+            bank: string;
+            type: string;
+            clockSpeed: number | null;
+            formFactor: string;
+        }>;
+    };
+    graphics: {
+        controllers: Array<{
+            model: string;
+            vendor: string;
+            vram: number | null;
+            bus: string;
+        }>;
+        displays: Array<{
+            model: string;
+            main: boolean;
+            resolutionX: number | null;
+            resolutionY: number | null;
+            refreshRate: number | null;
+            sizeX: number | null;
+            sizeY: number | null;
+        }>;
+    };
+    storage: Array<{
+        type: string;
+        name: string;
+        vendor: string;
+        size: number;
+        interface: string;
+    }>;
+    baseboard: {
+        manufacturer: string;
+        model: string;
+        version: string;
+        memMax: number | null;
+        memSlots: number | null;
+    };
+    os: {
+        platform: string;
+        distro: string;
+        release: string;
+        arch: string;
+        locale?: string;
+    };
+}
+/**
+ * Real-time system performance data.
+ */
+export interface PerformanceStatus {
+    cpuLoad: {
+        currentLoad: number;
+        currentLoadUser: number;
+        currentLoadSystem: number;
+        rawCurrentLoad: number;
+    };
+    memoryUsage: {
+        total: number;
+        used: number;
+        active: number;
+        available: number;
+        swaptotal: number;
+        swapused: number;
+    };
+    topProcesses: Array<{
+        name: string;
+        cpu: number;
+        mem: number;
+    }>;
+}
+/**
+ * Common configuration for the MCP server.
+ */
+export interface AppConfig {
+    remoteApiUrl: string;
+    serverName: string;
+    serverVersion: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@yamaru-eu/hardware-probe",
+  "version": "1.0.3",
+  "description": "Official Yamaru Hardware Probe — MCP local agent for hardware inventory and AI diagnostics",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "yamaru-probe": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yamaru-eu/hardware-probe.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "inspector": "mcp-inspector node dist/index.js",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "systeminformation": "^5.23.5"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.21.1",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}