oth-mcp 0.1.4 → 0.1.5

package/README.md

@@ -13,12 +13,15 @@ The server is designed for minimal token usage. Instead of embedding the full AP
 
 ## Setup
 
+**Defaults with no env set:** `OTH_ENV=dev` → base URL `https://doccla-dev.oth.io`, credentials read from Keychain account `oth-dev`. Override `OTH_ENV` (`dev`, `stag`, `demo`, `local`) to target another environment — the Keychain account name follows as `oth-<env>`.
+
 ### 1. Configure credentials
 
 **macOS Keychain (preferred)** — no plaintext on disk:
 
 ```bash
-# For each environment (oth-dev, oth-stag, oth-demo):
+# Account name is oth-<env>, so repeat per env you use
+# (oth-dev, oth-stag, oth-demo, oth-local):
 security add-generic-password -a "oth-dev" -s "oth-mcp-username" -w
 security add-generic-password -a "oth-dev" -s "oth-mcp-password" -w
 ```
@@ -31,12 +34,47 @@ export OTH_PASSWORD="your-password"
 export OTH_ENV="dev"  # optional, defaults to dev
 ```
 
-### 2. Add to Claude Code
+### 2. Add to Claude Code (no env default dev)
 
 ```bash
 claude mcp add oth -- npx -y oth-mcp
 ```
 
+Pass env vars with `-e KEY=VALUE` (repeatable). Example pointing at a local opentele stack with inline creds:
+
+```bash
+claude mcp add oth \
+  -e OTH_ENV=local \
+  -e OTH_USERNAME=admin \
+  -e OTH_PASSWORD=admin_23 \
+  -- npx -y oth-mcp
+```
+
+Omit `OTH_USERNAME`/`OTH_PASSWORD` if you've stored them in Keychain under `oth-local`. Use `-e OTH_BASE_URL=http://host.docker.internal:7100` if the default `http://localhost:7100` isn't reachable.
+
+### Local OTH (docker)
+
+To point the MCP at a local opentele stack run via docker:
+
+```bash
+# in the opentele repo:
+cd dev && docker compose up -d --wait
+
+# then launch the MCP with:
+export OTH_ENV=local          # → http://localhost:7100
+export OTH_USERNAME=admin
+export OTH_PASSWORD=admin_23  # or any dev account — see opentele docs
+```
+
+Or store local creds in Keychain under the `oth-local` account:
+
+```bash
+security add-generic-password -a "oth-local" -s "oth-mcp-username" -w
+security add-generic-password -a "oth-local" -s "oth-mcp-password" -w
+```
+
+Set `OTH_BASE_URL` to override the host/port (e.g. `http://host.docker.internal:7100`) if you're not on the default.
+
 ## Tools
 
 ### `oth_get`

package/dist/auth.js

@@ -1,8 +1,11 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
+const ENV_URLS = {
+    local: "http://localhost:7100",
+};
 function envBaseUrl(env) {
-    return `https://doccla-${env}.oth.io`;
+    return ENV_URLS[env] ?? `https://doccla-${env}.oth.io`;
 }
 const REFRESH_BUFFER_SECONDS = 60;
 const AUTH_ERROR_MESSAGES = {
@@ -27,7 +30,7 @@ export class AuthManager {
         return this.env;
     }
     get baseUrl() {
-        return envBaseUrl(this.env);
+        return process.env.OTH_BASE_URL ?? envBaseUrl(this.env);
     }
     get isAuthenticated() {
         return this.state !== null;

package/dist/tools.js

@@ -133,9 +133,9 @@ Read the oth://api-guide resource for full endpoint reference.`,
         },
         inputSchema: {
             environment: z
-                .enum(["dev", "stag", "demo"])
+                .enum(["dev", "stag", "demo", "local"])
                 .optional()
-                .describe("Target environment. Omit to show current state."),
+                .describe("Target environment. Omit to show current state. 'local' targets http://localhost:7100 (opentele docker stack); set OTH_BASE_URL to override."),
         },
     }, async ({ environment }) => {
         if (environment) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oth-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MCP server for the OTH (OpenTeleHealth) API",
   "type": "module",
   "bin": {