@ncodeuy/medplum-mcp 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,105 @@
+# @ncodeuy/medplum-mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that provides access to [Medplum](https://www.medplum.com/) FHIR healthcare data. It enables Claude and other MCP clients to read, search, and query FHIR resources from one or more Medplum environments.
+
+## Features
+
+- **Multi-environment support** — connect to multiple Medplum projects (e.g. dev, staging, production) and switch between them per request
+- **30 FHIR resource types** — Patient, Practitioner, Observation, Condition, MedicationRequest, and more
+- **Search with parameters** — query resources using standard FHIR search parameters
+- **Resource history** — view version history of any resource with pagination
+
+## Tools
+
+The server exposes 5 MCP tools:
+
+| Tool | Description |
+|---|---|
+| `fhir_get_environments` | List available Medplum environments and the default |
+| `fhir_get_resource_types` | List supported FHIR resource types and their search parameters |
+| `fhir_read` | Read a single FHIR resource by type and ID |
+| `fhir_search` | Search for FHIR resources with query parameters |
+| `fhir_read_history` | Get version history of a resource |
+
+## Setup
+
+### Install
+
+```bash
+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:
+
+```bash
+MEDPLUM_PROJECTS='{
+  "staging": {
+    "baseUrl": "https://staging.example.com/",
+    "clientId": "staging-client-id",
+    "clientSecret": "staging-secret",
+    "projectId": "proj-staging"
+  },
+  "production": {
+    "baseUrl": "https://api.medplum.com/",
+    "clientId": "prod-client-id",
+    "clientSecret": "prod-secret",
+    "projectId": "proj-prod"
+  }
+}'
+MEDPLUM_DEFAULT_PROJECT=staging
+```
+
+`MEDPLUM_DEFAULT_PROJECT` is optional and defaults to the first entry.
+
+### Use with Claude Desktop
+
+Add the server to your Claude Desktop configuration (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "medplum": {
+      "command": "npx",
+      "args": ["@ncodeuy/medplum-mcp"],
+      "env": {
+        "MEDPLUM_PROJECTS": "{\"default\":{\"clientId\":\"your-client-id\",\"clientSecret\":\"your-client-secret\"}}"
+      }
+    }
+  }
+}
+```
+
+### Use with Claude Code
+
+Add the server to your Claude Code MCP settings:
+
+```bash
+claude mcp add medplum -- npx @ncodeuy/medplum-mcp
+```
+
+Then set the required environment variables in your shell before launching Claude Code.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Type check
+npm run typecheck
+
+# Run tests
+npm test
+
+# Build
+npm run build
+
+# Run the server locally
+node ./dist/index.js
+```
+
+## License
+
+ISC

package/dist/config.js

@@ -34,20 +34,5 @@ export function loadConfig() {
         }
         return { projects, defaultProject };
     }
-    // Legacy single-project fallback
-    const clientId = process.env.MEDPLUM_CLIENT_ID;
-    const clientSecret = process.env.MEDPLUM_CLIENT_SECRET;
-    if (!clientId || !clientSecret) {
-        throw new Error("Missing MEDPLUM_PROJECTS or MEDPLUM_CLIENT_ID/MEDPLUM_CLIENT_SECRET environment variables.");
-    }
-    return {
-        projects: {
-            default: {
-                baseUrl: process.env.MEDPLUM_BASE_URL || "https://api.medplum.com/",
-                clientId,
-                clientSecret,
-            },
-        },
-        defaultProject: "default",
-    };
+    throw new Error("Missing MEDPLUM_PROJECTS environment variable. Set it to a JSON object mapping environment names to project configs.");
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@ncodeuy/medplum-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "medplum-mcp": "./dist/index.js"
+    "medplum-mcp": "dist/index.js"
   },
   "files": [
     "dist"