@ncodeuy/medplum-mcp 0.1.2 → 0.2.0

package/README.md

@@ -31,7 +31,29 @@ npm install @ncodeuy/medplum-mcp
 
 ### Configure
 
-The server reads configuration from the `MEDPLUM_PROJECTS` environment variable — a JSON object mapping environment names to their connection details:
+Set one environment variable per field, using the pattern `MEDPLUM_PROJECT_<NAME>_<FIELD>`:
+
+```bash
+# Required
+MEDPLUM_PROJECT_STAGING_CLIENT_ID=staging-client-id
+MEDPLUM_PROJECT_STAGING_CLIENT_SECRET=staging-secret
+
+# Optional (defaults to https://api.medplum.com/)
+MEDPLUM_PROJECT_STAGING_BASE_URL=https://staging.example.com/
+MEDPLUM_PROJECT_STAGING_PROJECT_ID=proj-staging
+
+# Add more projects by changing the name segment
+MEDPLUM_PROJECT_PRODUCTION_CLIENT_ID=prod-client-id
+MEDPLUM_PROJECT_PRODUCTION_CLIENT_SECRET=prod-secret
+
+# Optional — defaults to the first project found
+MEDPLUM_DEFAULT_PROJECT=staging
+```
+
+<details>
+<summary>Alternative: JSON configuration</summary>
+
+You can also use the `MEDPLUM_PROJECTS` environment variable with a JSON object:
 
 ```bash
 MEDPLUM_PROJECTS='{
@@ -42,16 +64,15 @@ MEDPLUM_PROJECTS='{
     "projectId": "proj-staging"
   },
   "production": {
-    "baseUrl": "https://api.medplum.com/",
     "clientId": "prod-client-id",
-    "clientSecret": "prod-secret",
-    "projectId": "proj-prod"
+    "clientSecret": "prod-secret"
   }
 }'
-MEDPLUM_DEFAULT_PROJECT=staging
 ```
 
-`MEDPLUM_DEFAULT_PROJECT` is optional and defaults to the first entry.
+Flat env vars take priority when both are set.
+
+</details>
 
 ### Use with Claude Desktop
 
@@ -64,7 +85,8 @@ Add the server to your Claude Desktop configuration (`claude_desktop_config.json
       "command": "npx",
       "args": ["@ncodeuy/medplum-mcp"],
       "env": {
-        "MEDPLUM_PROJECTS": "{\"default\":{\"clientId\":\"your-client-id\",\"clientSecret\":\"your-client-secret\"}}"
+        "MEDPLUM_PROJECT_DEFAULT_CLIENT_ID": "your-client-id",
+        "MEDPLUM_PROJECT_DEFAULT_CLIENT_SECRET": "your-client-secret"
       }
     }
   }
@@ -76,11 +98,12 @@ Add the server to your Claude Desktop configuration (`claude_desktop_config.json
 Add the server to your Claude Code MCP settings:
 
 ```bash
-claude mcp add medplum -- npx @ncodeuy/medplum-mcp
+claude mcp add medplum \
+  -e MEDPLUM_PROJECT_DEFAULT_CLIENT_ID=your-client-id \
+  -e MEDPLUM_PROJECT_DEFAULT_CLIENT_SECRET=your-client-secret \
+  -- npx @ncodeuy/medplum-mcp
 ```
 
-Then set the required environment variables in your shell before launching Claude Code.
-
 ## Development
 
 ```bash

package/dist/config.js

@@ -1,4 +1,46 @@
+const ENV_PREFIX = "MEDPLUM_PROJECT_";
+const CLIENT_ID_SUFFIX = "_CLIENT_ID";
+function loadFromEnvVars() {
+    const projects = {};
+    for (const key of Object.keys(process.env)) {
+        if (!key.startsWith(ENV_PREFIX) || !key.endsWith(CLIENT_ID_SUFFIX)) {
+            continue;
+        }
+        const name = key
+            .slice(ENV_PREFIX.length, -CLIENT_ID_SUFFIX.length)
+            .toLowerCase();
+        if (!name)
+            continue;
+        const prefix = `${ENV_PREFIX}${key.slice(ENV_PREFIX.length, -CLIENT_ID_SUFFIX.length)}_`;
+        const clientId = process.env[key];
+        const clientSecret = process.env[`${prefix}CLIENT_SECRET`];
+        if (!clientSecret) {
+            throw new Error(`${prefix}CLIENT_SECRET is required when ${key} is set.`);
+        }
+        projects[name] = {
+            baseUrl: process.env[`${prefix}BASE_URL`] || "https://api.medplum.com/",
+            clientId: clientId,
+            clientSecret,
+            projectId: process.env[`${prefix}PROJECT_ID`],
+        };
+    }
+    return Object.keys(projects).length > 0 ? projects : undefined;
+}
+function resolveDefault(projects) {
+    const keys = Object.keys(projects);
+    const defaultProject = process.env.MEDPLUM_DEFAULT_PROJECT || keys[0];
+    if (!projects[defaultProject]) {
+        throw new Error(`MEDPLUM_DEFAULT_PROJECT "${defaultProject}" not found. Available: ${keys.join(", ")}`);
+    }
+    return { projects, defaultProject };
+}
 export function loadConfig() {
+    // 1. Try flat environment variables
+    const flatProjects = loadFromEnvVars();
+    if (flatProjects) {
+        return resolveDefault(flatProjects);
+    }
+    // 2. Fall back to MEDPLUM_PROJECTS JSON
     const projectsJson = process.env.MEDPLUM_PROJECTS;
     if (projectsJson) {
         let parsed;
@@ -28,11 +70,8 @@ export function loadConfig() {
         if (keys.length === 0) {
             throw new Error("MEDPLUM_PROJECTS must contain at least one environment.");
         }
-        const defaultProject = process.env.MEDPLUM_DEFAULT_PROJECT || keys[0];
-        if (!projects[defaultProject]) {
-            throw new Error(`MEDPLUM_DEFAULT_PROJECT "${defaultProject}" not found in MEDPLUM_PROJECTS. Available: ${keys.join(", ")}`);
-        }
-        return { projects, defaultProject };
+        return resolveDefault(projects);
     }
-    throw new Error("Missing MEDPLUM_PROJECTS environment variable. Set it to a JSON object mapping environment names to project configs.");
+    // 3. Nothing configured
+    throw new Error("Missing configuration. Set MEDPLUM_PROJECT_<NAME>_CLIENT_ID environment variables, or set MEDPLUM_PROJECTS as a JSON object.");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncodeuy/medplum-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",