@martin4455/matomo-mcp-ro 0.4.1 → 0.4.2

package/CONFIGURATION.md

@@ -1,6 +1,6 @@
 # Matomo MCP configuration guide
 
-For the quick setup, see the [README](README.md). This guide describes version 0.4.0 and newer.
+For the quick setup, see the [README](README.md). This guide describes version 0.4.2 and newer.
 
 ## Source setup
 
@@ -34,10 +34,13 @@ read-only site-list request. Old-format records are invalid; enter the complete
 connection again with `configure`. Enter retains valid saved credentials;
 changing the URL requires new credentials.
 
-The file `.matomo-mcp.json` lives in the exact current directory, or at an explicit
-`--config /project/.matomo-mcp.json` path. No home/parent/environment fallback is
-used. It contains only a reference, protected by mode 0600 on Unix or a private
-Windows ACL:
+The file `.matomo-mcp.json` lives in the exact current directory by default.
+`--config .` selects that same directory; `--config "/path/to/project"` selects
+another existing project directory. You can also pass the file path directly,
+as in `--config "/path/to/project/.matomo-mcp.json"`.
+Relative paths, including `.`, resolve from the server process's working
+directory at startup. No home/parent/environment fallback is used. The file
+contains only a reference, protected by mode 0600 on Unix or a private Windows ACL:
 
 ```json
 {
@@ -180,13 +183,16 @@ The [README](README.md#3-connect-your-client) shows the CLI registration command
 For a stable installation, `client-config codex`, `client-config claude-code` and
 `client-config claude-desktop` print settings with absolute paths and no secrets.
 These settings launch the installed Node.js executable and package directly.
-Use `--config` to select the project you configured:
+From the directory you configured, generate the client settings with `--config .`:
 
 ```sh
-matomo-mcp client-config codex --config "/absolute/path/to/project/.matomo-mcp.json"
-matomo-mcp client-config claude-code --config "/absolute/path/to/project/.matomo-mcp.json"
+matomo-mcp client-config codex --config .
+matomo-mcp client-config claude-code --config .
 ```
 
+The generator expands `.` to an absolute configuration file path, so the printed
+settings work when the client starts from another directory too.
+
 Merge the Codex TOML into `~/.codex/config.toml`, or the trusted project's
 `.codex/config.toml` for project scope. Codex CLI and Desktop share these settings.
 The generated server name is `matomo`; README registration examples use
@@ -196,10 +202,10 @@ and [Claude Code MCP](https://code.claude.com/docs/en/mcp).
 
 ### Claude Desktop setup
 
-Generate the desktop configuration:
+From the directory you configured, generate the desktop configuration:
 
 ```sh
-matomo-mcp client-config claude-desktop --config "/absolute/path/to/project/.matomo-mcp.json"
+matomo-mcp client-config claude-desktop --config .
 ```
 
 Open Claude Desktop's **Settings → Developer → Edit Config** and merge the printed
@@ -222,9 +228,9 @@ utilities. Keyring access uses native APIs inside Node; it does not launch shell
 
 ## Troubleshooting
 
-- Run `matomo-mcp status --config "/absolute/path/to/project/.matomo-mcp.json"` to
+- From the configured project directory, run `matomo-mcp status --config .` to
   check the local file and stored credentials without an HTTP request.
-- Run `matomo-mcp check --config "/absolute/path/to/project/.matomo-mcp.json"` to
+- Run `matomo-mcp check --config .` from that directory to
   test access to Matomo. A token needs access to at least one site.
 - If credentials are invalid or missing, run `configure` again with the same
   `--config`. An unavailable credential store must be unlocked or repaired first.

package/README.md

@@ -14,7 +14,7 @@ node -v
 npm install -g @martin4455/matomo-mcp-ro@latest
 ```
 
-The encrypted storage described here requires version **0.4.0+**. For an unreleased
+These setup instructions require version **0.4.2+**. For an unreleased
 checkout, use the [source setup](CONFIGURATION.md#source-setup).
 
 ## 2. Configure
@@ -44,23 +44,24 @@ Existing entries in the old format are treated as invalid credentials. Run
 
 ## 3. Connect your client
 
-From the same project directory, run the command for your client. Replace the quoted
-path with the absolute path to the configuration file created above.
+From the same project directory, run the command for your client.
 
 **Claude Code:**
 
 ```sh
-claude mcp add matomo-local -- npx -y \
-  @martin4455/matomo-mcp-ro@latest \
-  --config "/absolute/path/to/project/.matomo-mcp.json"
+claude mcp add matomo-local -- npx -y @martin4455/matomo-mcp-ro@latest --config .
 ```
 
+Start Claude Code from this directory so `.` selects your local configuration.
+For Windows launch problems, see [launcher troubleshooting](CONFIGURATION.md#troubleshooting).
+
 **Codex CLI:**
 
+Replace the quoted path with the directory you configured above.
+
 ```sh
 codex mcp add matomo-local -- npx -y \
-  @martin4455/matomo-mcp-ro@latest \
-  --config "/absolute/path/to/project/.matomo-mcp.json"
+  @martin4455/matomo-mcp-ro@latest --config "/absolute/path/to/project"
 ```
 
 **Claude Desktop:** follow the [Desktop setup](CONFIGURATION.md#claude-desktop-setup).

package/cli.mjs

@@ -8,14 +8,14 @@ import { clientConfiguration } from './lib/client-config.mjs';
 import { VERSION } from './lib/version.mjs';
 
 export { VERSION };
-const help = `Matomo MCP - lokalny adapter Reporting API, tylko do odczytu\n\nUżycie: matomo-mcp [polecenie] [--config /ścieżka/${CONFIG_NAME}]\n\n  configure                    Wpisz dane w terminalu, sprawdź i zapisz w keyringu\n  check                        Sprawdź prawa pliku, keyring i połączenie z Matomo\n  status                       Sprawdź konfigurację i keyring bez HTTP\n  serve                        Uruchom MCP przez stdio (polecenie domyślne)\n  client-config codex          Wypisz wpis TOML z bezpośrednim startem Node.js\n  client-config claude-code    Wypisz wpis MCP JSON dla Claude Code\n  client-config claude-desktop Wypisz wpis MCP JSON dla Claude Desktop\n  --help / --version\n\nBez --config używany jest wyłącznie plik ${CONFIG_NAME} w bieżącym katalogu.\nURL, token i Basic Auth są w systemowym keyringu; plik zawiera tylko odwołanie.\nToken i dane HTTP Auth wpisuj tylko w configure, nigdy w argumentach poleceń.\n`;
+const help = `Matomo MCP - lokalny adapter Reporting API, tylko do odczytu\n\nUżycie: matomo-mcp [polecenie] [--config katalog-lub-plik]\n\n  configure                    Wpisz dane w terminalu, sprawdź i zapisz w keyringu\n  check                        Sprawdź prawa pliku, keyring i połączenie z Matomo\n  status                       Sprawdź konfigurację i keyring bez HTTP\n  serve                        Uruchom MCP przez stdio (polecenie domyślne)\n  client-config codex          Wypisz wpis TOML z bezpośrednim startem Node.js\n  client-config claude-code    Wypisz wpis MCP JSON dla Claude Code\n  client-config claude-desktop Wypisz wpis MCP JSON dla Claude Desktop\n  --help / --version\n\n--config . wybiera plik ${CONFIG_NAME} w bieżącym katalogu.\nMożesz też podać inny katalog projektu lub ścieżkę do pliku konfiguracji.\nBez --config używany jest wyłącznie plik ${CONFIG_NAME} w bieżącym katalogu.\nURL, token i Basic Auth są w systemowym keyringu; plik zawiera tylko odwołanie.\nToken i dane HTTP Auth wpisuj tylko w configure, nigdy w argumentach poleceń.\n`;
 
 export function parseArguments(argv) {
   let config;
   const positional = [];
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--config') {
-      if (config !== undefined || !argv[i + 1] || argv[i + 1].startsWith('-')) throw new ConfigError('Po --config podaj ścieżkę do pliku konfiguracji.');
+      if (config !== undefined || !argv[i + 1] || argv[i + 1].startsWith('-')) throw new ConfigError('Po --config podaj katalog projektu lub ścieżkę do pliku konfiguracji.');
       config = argv[++i];
     } else if (['--help', '-h', '--version'].includes(argv[i])) positional.push(argv[i]);
     else if (argv[i].startsWith('-')) throw new ConfigError('Nieznana opcja. Użyj --help.');

package/lib/config.mjs

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import { statSync } from 'node:fs';
 import path from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
@@ -32,7 +33,15 @@ export function validateConfig(value) {
   if (!parsed.success) throw new ConfigError('Nieprawidłowa konfiguracja Matomo. Wymagane są adres HTTPS i token; opcjonalny Basic Auth wymaga loginu i hasła.');
   return { ...parsed.data, baseUrl: normalizeBaseUrl(parsed.data.baseUrl) };
 }
-export function resolveConfigPath(explicit, cwd = process.cwd()) { return path.resolve(cwd, explicit ?? CONFIG_NAME); }
+export function resolveConfigPath(explicit, cwd = process.cwd()) {
+  const target = path.resolve(cwd, explicit ?? CONFIG_NAME);
+  if (explicit === undefined) return target;
+  try {
+    return statSync(target, { throwIfNoEntry: false })?.isDirectory() ? path.join(target, CONFIG_NAME) : target;
+  } catch {
+    throw new ConfigError('Nie można sprawdzić ścieżki konfiguracji. Sprawdź prawa do pliku lub katalogu.', 'CONFIG_READ_FAILED');
+  }
+}
 
 export async function readConfigRecord(target, options) {
   const file = await readConfigFile(target, options);

package/lib/version.mjs

@@ -1 +1 @@
-export const VERSION = '0.4.1';
+export const VERSION = '0.4.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@martin4455/matomo-mcp-ro",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Read-only Matomo Reporting API MCP with HTTP Basic Auth and project-local configuration",
   "type": "module",
   "bin": {