phpstan-mcp-mx 0.1.0 → 0.1.1

package/README.md

@@ -5,19 +5,24 @@ bedient meerdere PHP-projecten tegelijk; welke dat zijn, leg je zelf vast.
 
 ## Installatie
 
+Met `--scope user` is de server in al je projecten beschikbaar — wat je wilt bij één server
+die meerdere projecten bedient.
+
 ```bash
-claude mcp add phpstan \
+npm install -g phpstan-mcp-mx
+
+claude mcp add phpstan --scope user \
   --env PHPSTAN_MCP_ROOTS=/pad/naar/projecten \
-  -- npx -y phpstan-mcp-mx
+  -- phpstan-mcp-mx
 ```
 
-Of, als je de repo lokaal hebt staan:
+Zonder globale installatie kan het ook rechtstreeks van de registry; dat kost wel elke
+sessiestart een npx-resolutie:
 
 ```bash
-npm install && npm run build
-claude mcp add phpstan \
+claude mcp add phpstan --scope user \
   --env PHPSTAN_MCP_ROOTS=/pad/naar/projecten \
-  -- node /pad/naar/phpstan-mcp-mx/dist/index.js
+  -- npx -y phpstan-mcp-mx
 ```
 
 Voor Claude Desktop komt hetzelfde in `claude_desktop_config.json`:
@@ -26,14 +31,91 @@ Voor Claude Desktop komt hetzelfde in `claude_desktop_config.json`:
 {
   "mcpServers": {
     "phpstan": {
-      "command": "npx",
-      "args": ["-y", "phpstan-mcp-mx"],
+      "command": "phpstan-mcp-mx",
       "env": { "PHPSTAN_MCP_ROOTS": "/pad/naar/projecten" }
     }
   }
 }
 ```
 
+### Als de server niet start: PATH
+
+Krijg je iets als `env: node: No such file or directory`, of blijft de server op "failed to
+connect" staan, dan is dit vrijwel altijd de oorzaak.
+
+Het commando `phpstan-mcp-mx` is een script dat begint met `#!/usr/bin/env node`, en `npx`
+is zelf ook een commando dat gevonden moet worden. Allebei werken ze in je terminal omdat je
+shell-profiel Node op `PATH` zet. Maar de MCP-server wordt gestart door een ánder programma,
+en dat erft je shell-profiel niet altijd — een GUI-app op macOS krijgt vaak alleen een kale
+`PATH` met `/usr/bin` en `/bin`. Node staat daar niet: Homebrew zet hem in
+`/opt/homebrew/bin`, en nvm, fnm, asdf en volta ergens onder je home.
+
+De oplossing is absolute paden gebruiken, zodat er niets meer opgezocht hoeft te worden:
+
+```bash
+command -v node   # bijv. /opt/homebrew/bin/node
+npm root -g       # bijv. /opt/homebrew/lib/node_modules
+```
+
+```bash
+claude mcp add phpstan --scope user \
+  --env PHPSTAN_MCP_ROOTS=/pad/naar/projecten \
+  -- /opt/homebrew/bin/node /opt/homebrew/lib/node_modules/phpstan-mcp-mx/dist/index.js
+```
+
+En voor Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "phpstan": {
+      "command": "/opt/homebrew/bin/node",
+      "args": ["/opt/homebrew/lib/node_modules/phpstan-mcp-mx/dist/index.js"],
+      "env": { "PHPSTAN_MCP_ROOTS": "/pad/naar/projecten" }
+    }
+  }
+}
+```
+
+Zelf nagaan of het aan `PATH` ligt, zonder de MCP-client erbij te halen. Het binary wordt
+eerst in je eigen shell opgezocht en daarna met een kale `PATH` gestart — anders is het
+commando zelf al onvindbaar en meet je iets anders:
+
+```bash
+echo '' | env -i PATH=/usr/bin:/bin "$(command -v phpstan-mcp-mx)"
+```
+
+```
+env: node: No such file or directory
+```
+
+Komt dat eruit, dan weet je genoeg. Dezelfde test op de absolute variant hoort gewoon te
+starten:
+
+```bash
+echo '' | env -i PATH=/usr/bin:/bin \
+  /opt/homebrew/bin/node /opt/homebrew/lib/node_modules/phpstan-mcp-mx/dist/index.js
+```
+
+```
+phpstan-mcp 0.1.0 luistert op stdio, 0 root(s) geconfigureerd
+```
+
+(Nul roots klopt hier: `env -i` gooit ook `PHPSTAN_MCP_ROOTS` weg. Het gaat er alleen om dát
+hij start.)
+
+### Vanuit de repo
+
+```bash
+npm install && npm run build
+claude mcp add phpstan --scope user \
+  --env PHPSTAN_MCP_ROOTS=/pad/naar/projecten \
+  -- node /pad/naar/phpstan-mcp-mx/dist/index.js
+```
+
+Let op dat je dan vastzit aan die map: verplaats of verwijder je hem, dan faalt de server in
+al je projecten.
+
 ## Configuratie
 
 `PHPSTAN_MCP_ROOTS` is verplicht: een lijst absolute paden, gescheiden door een dubbele punt

package/dist/server.d.ts

@@ -5,7 +5,7 @@ import type { Root } from './roots.js';
  * package.json; die kan hier niet zomaar geïmporteerd worden, want een JSON-import
  * verhuist bij het bouwen mee naar dist/ en wijst dan naar het verkeerde bestand.
  */
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.1";
 /**
  * Bouwt de MCP-server met de tools die op deze set roots van toepassing zijn.
  * De roots worden één keer bij het opstarten ingelezen: ze komen uit de

package/dist/server.js

@@ -5,7 +5,7 @@ import { registerTools } from './tools.js';
  * package.json; die kan hier niet zomaar geïmporteerd worden, want een JSON-import
  * verhuist bij het bouwen mee naar dist/ en wijst dan naar het verkeerde bestand.
  */
-export const VERSION = '0.1.0';
+export const VERSION = '0.1.1';
 /**
  * Bouwt de MCP-server met de tools die op deze set roots van toepassing zijn.
  * De roots worden één keer bij het opstarten ingelezen: ze komen uit de

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phpstan-mcp-mx",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP-server die PHPStan ontsluit als tools, voor meerdere PHP-projecten tegelijk",
   "keywords": [
     "mcp",