@fhirfly-io/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FHIRfly.io LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# @fhirfly-io/mcp-server
+
+MCP (Model Context Protocol) server for connecting Claude Desktop to [FHIRfly](https://fhirfly.io) healthcare reference data APIs.
+
+## What is this?
+
+This package lets Claude Desktop look up real healthcare reference data including:
+
+- **NDC** - Drug products and packages (FDA)
+- **NPI** - Healthcare provider identifiers (CMS)
+- **RxNorm** - Drug terminology (NLM)
+- **LOINC** - Laboratory codes (Regenstrief Institute)
+- **ICD-10** - Diagnosis and procedure codes (CMS)
+- **CVX/MVX** - Vaccine codes (CDC)
+- **FDA Drug Labels** - Prescribing information
+
+When you ask Claude about medications, providers, or clinical codes, it can look up accurate, current information instead of relying on training data.
+
+## Prerequisites
+
+1. **Claude Desktop** - Download from [claude.ai/download](https://claude.ai/download)
+2. **Node.js 18+** - Download from [nodejs.org](https://nodejs.org)
+3. **FHIRfly API Key** - Get one at [fhirfly.io](https://fhirfly.io) (free tier available)
+
+## Quick Setup
+
+### Step 1: Get a FHIRfly API Key
+
+1. Go to [fhirfly.io](https://fhirfly.io) and sign up
+2. Navigate to **Dashboard > Credentials**
+3. Click **Create Credential** and select **MCP (Claude Desktop)**
+4. Copy your API key (starts with `ffly_`)
+
+### Step 2: Configure Claude Desktop
+
+Find your Claude Desktop config file:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add the FHIRfly server configuration:
+
+```json
+{
+  "mcpServers": {
+    "fhirfly": {
+      "command": "npx",
+      "args": ["-y", "@fhirfly-io/mcp-server"],
+      "env": {
+        "FHIRFLY_API_KEY": "ffly_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Replace `ffly_live_your_key_here` with your actual API key.
+
+### Step 3: Restart Claude Desktop
+
+Completely quit Claude Desktop and reopen it. The FHIRfly tools should now be available.
+
+## Verify It Works
+
+Try asking Claude:
+
+- "What is NDC 0069-0151-01?"
+- "Look up NPI 1234567893"
+- "Search for COVID vaccines in the CVX database"
+- "What are the drug interactions for Lipitor?"
+
+Claude should use the FHIRfly tools to look up real data.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `ndc_get` | Look up drug by NDC code |
+| `ndc_search` | Search drugs by name, ingredient, etc. |
+| `npi_get` | Look up provider by NPI number |
+| `npi_search` | Search providers by name, specialty, location |
+| `rxnorm_get` | Look up drug by RxCUI |
+| `rxnorm_search` | Search drug terminology |
+| `loinc_get` | Look up lab test by LOINC code |
+| `loinc_search` | Search lab codes |
+| `icd10_get` | Look up diagnosis/procedure code |
+| `icd10_search` | Search ICD-10 codes |
+| `cvx_get` | Look up vaccine by CVX code |
+| `cvx_search` | Search vaccine codes |
+| `mvx_get` | Look up vaccine manufacturer |
+| `mvx_search` | Search manufacturers |
+| `fda_label_lookup` | Look up FDA drug label |
+| `fda_label_search` | Search drug labels |
+| `fda_label_safety` | Get safety info (boxed warnings, contraindications) |
+| `fda_label_interactions` | Get drug interaction info |
+| `fda_label_dosing` | Get dosing information |
+| `fda_label_sections` | Get specific label sections |
+
+## Configuration Options
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `FHIRFLY_API_KEY` | Your FHIRfly API key (required) | - |
+| `FHIRFLY_API_URL` | API base URL | `https://api.fhirfly.io` |
+| `FHIRFLY_DEBUG` | Enable debug logging (`1` or `true`) | `false` |
+
+## Troubleshooting
+
+### "FHIRFLY_API_KEY environment variable is required"
+
+Your API key isn't configured. Make sure:
+1. You have a valid API key from [fhirfly.io](https://fhirfly.io)
+2. It's set in the `env` section of your Claude Desktop config
+3. The key starts with `ffly_`
+
+### "Invalid API key format"
+
+FHIRfly API keys start with `ffly_`. Check that you copied the full key.
+
+### "Authentication failed"
+
+Your API key may be invalid or expired. Generate a new one at [fhirfly.io/dashboard/credentials](https://fhirfly.io/dashboard/credentials).
+
+### Claude doesn't show FHIRfly tools
+
+1. Make sure you completely quit and restarted Claude Desktop
+2. Check your config file syntax (must be valid JSON)
+3. Enable debug mode to see what's happening:
+
+```json
+{
+  "mcpServers": {
+    "fhirfly": {
+      "command": "npx",
+      "args": ["-y", "@fhirfly-io/mcp-server"],
+      "env": {
+        "FHIRFLY_API_KEY": "your_key",
+        "FHIRFLY_DEBUG": "1"
+      }
+    }
+  }
+}
+```
+
+### "Rate limit exceeded"
+
+You've hit your plan's rate limit. Wait a moment and try again, or upgrade your plan at [fhirfly.io](https://fhirfly.io).
+
+## How It Works
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│  Claude Desktop │────▶│  This Package   │────▶│  FHIRfly API    │
+│                 │     │  (runs locally) │     │  (cloud)        │
+│  "What is       │◀────│                 │◀────│                 │
+│   NDC 123..."   │     │  Translates MCP │     │  Returns drug   │
+│                 │     │  ↔ HTTPS        │     │  data           │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+```
+
+This package runs on your computer as a bridge between Claude Desktop and the FHIRfly API. It:
+
+1. Receives requests from Claude Desktop via stdin
+2. Translates them to HTTPS requests to FHIRfly
+3. Returns the results to Claude via stdout
+
+Your API key is sent to FHIRfly over HTTPS. No healthcare data is stored locally.
+
+## Links
+
+- [FHIRfly Documentation](https://fhirfly.io/docs)
+- [MCP Setup Guide](https://fhirfly.io/docs/mcp/claude-desktop)
+- [Get an API Key](https://fhirfly.io)
+- [Report Issues](https://github.com/FHIRfly-io/fhirfly-mcp-server/issues)
+
+## License
+
+MIT - see [LICENSE](./LICENSE)

package/dist/cli.js

@@ -0,0 +1,431 @@
+#!/usr/bin/env node
+import { createInterface } from 'readline';
+
+var StdioTransport = class {
+  handler = null;
+  debug;
+  pendingRequests = 0;
+  stdinClosed = false;
+  constructor(debug = false) {
+    this.debug = debug;
+  }
+  /**
+   * Set the handler for incoming messages
+   */
+  setHandler(handler) {
+    this.handler = handler;
+  }
+  /**
+   * Start listening for messages on stdin
+   */
+  start() {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false
+    });
+    let buffer = "";
+    rl.on("line", async (line) => {
+      buffer += line;
+      try {
+        const request = JSON.parse(buffer);
+        buffer = "";
+        if (this.debug) {
+          console.error("[MCP DEBUG] Received:", JSON.stringify(request, null, 2));
+        }
+        if (this.handler) {
+          this.pendingRequests++;
+          try {
+            const response = await this.handler(request);
+            this.send(response);
+          } finally {
+            this.pendingRequests--;
+            this.maybeExit();
+          }
+        }
+      } catch {
+        if (line.trim().endsWith("}")) {
+          this.sendError(null, -32700, "Parse error: Invalid JSON");
+          buffer = "";
+        }
+      }
+    });
+    rl.on("close", () => {
+      this.stdinClosed = true;
+      if (this.debug) {
+        console.error("[MCP DEBUG] stdin closed, waiting for pending requests...");
+      }
+      this.maybeExit();
+    });
+    process.stdin.on("error", (err) => {
+      if (this.debug) {
+        console.error("[MCP DEBUG] stdin error:", err.message);
+      }
+    });
+  }
+  /**
+   * Exit if stdin is closed and no pending requests
+   */
+  maybeExit() {
+    if (this.stdinClosed && this.pendingRequests === 0) {
+      if (this.debug) {
+        console.error("[MCP DEBUG] All requests complete, exiting");
+      }
+      process.exit(0);
+    }
+  }
+  /**
+   * Send a JSON-RPC response to stdout
+   */
+  send(response) {
+    const message = JSON.stringify(response);
+    if (this.debug) {
+      console.error("[MCP DEBUG] Sending:", JSON.stringify(response, null, 2));
+    }
+    process.stdout.write(message + "\n");
+  }
+  /**
+   * Send an error response
+   */
+  sendError(id, code, message, data) {
+    this.send({
+      jsonrpc: "2.0",
+      id,
+      error: {
+        code,
+        message,
+        data
+      }
+    });
+  }
+};
+
+// src/client.ts
+var FhirflyClient = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Send a JSON-RPC request to the FHIRfly MCP endpoint
+   */
+  async request(method, params) {
+    const requestBody = {
+      jsonrpc: "2.0",
+      id: Date.now(),
+      method,
+      params
+    };
+    if (this.config.debug) {
+      console.error(`[MCP DEBUG] API Request: ${method}`, params);
+    }
+    try {
+      const response = await fetch(`${this.config.apiUrl}/mcp`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.config.apiKey,
+          "User-Agent": "@fhirfly-io/mcp-server"
+        },
+        body: JSON.stringify(requestBody)
+      });
+      if (!response.ok) {
+        if (response.status === 401) {
+          return {
+            jsonrpc: "2.0",
+            id: requestBody.id,
+            error: {
+              code: -32001,
+              message: "Authentication failed. Check your FHIRFLY_API_KEY."
+            }
+          };
+        }
+        if (response.status === 429) {
+          return {
+            jsonrpc: "2.0",
+            id: requestBody.id,
+            error: {
+              code: -32002,
+              message: "Rate limit exceeded. Please slow down requests."
+            }
+          };
+        }
+        return {
+          jsonrpc: "2.0",
+          id: requestBody.id,
+          error: {
+            code: -32e3,
+            message: `API error: ${response.status} ${response.statusText}`
+          }
+        };
+      }
+      const result = await response.json();
+      if (this.config.debug) {
+        console.error("[MCP DEBUG] API Response:", JSON.stringify(result, null, 2));
+      }
+      return result;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (this.config.debug) {
+        console.error("[MCP DEBUG] API Error:", message);
+      }
+      return {
+        jsonrpc: "2.0",
+        id: requestBody.id,
+        error: {
+          code: -32003,
+          message: `Network error: ${message}`
+        }
+      };
+    }
+  }
+  /**
+   * Get list of available tools from FHIRfly
+   */
+  async listTools() {
+    const response = await this.request("tools/list", {});
+    if (response.error) {
+      throw new Error(response.error.message);
+    }
+    return response.result;
+  }
+  /**
+   * Call a tool on the FHIRfly API
+   */
+  async callTool(name, args) {
+    const response = await this.request("tools/call", {
+      name,
+      arguments: args
+    });
+    if (response.error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              error: response.error.message,
+              code: response.error.code
+            })
+          }
+        ],
+        isError: true
+      };
+    }
+    return response.result;
+  }
+};
+
+// src/server.ts
+var MCP_ERRORS = {
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603
+};
+var SERVER_INFO = {
+  name: "fhirfly-mcp-server",
+  version: "0.1.0"
+};
+var SERVER_CAPABILITIES = {
+  tools: {}
+};
+var McpServer = class {
+  transport;
+  client;
+  config;
+  initialized = false;
+  constructor(config) {
+    this.config = config;
+    this.transport = new StdioTransport(config.debug);
+    this.client = new FhirflyClient(config);
+  }
+  /**
+   * Start the MCP server
+   */
+  start() {
+    if (this.config.debug) {
+      console.error("[MCP DEBUG] Starting FHIRfly MCP Server");
+      console.error("[MCP DEBUG] API URL:", this.config.apiUrl);
+      console.error("[MCP DEBUG] API Key:", this.config.apiKey.slice(0, 10) + "...");
+    }
+    this.transport.setHandler(this.handleMessage.bind(this));
+    this.transport.start();
+  }
+  /**
+   * Handle incoming JSON-RPC messages
+   */
+  async handleMessage(request) {
+    try {
+      if (request.jsonrpc !== "2.0" || !request.method) {
+        return {
+          jsonrpc: "2.0",
+          id: request.id ?? null,
+          error: {
+            code: MCP_ERRORS.INVALID_REQUEST,
+            message: "Invalid JSON-RPC request"
+          }
+        };
+      }
+      switch (request.method) {
+        case "initialize":
+          return this.handleInitialize(request);
+        case "initialized":
+          this.initialized = true;
+          return {
+            jsonrpc: "2.0",
+            id: request.id,
+            result: {}
+          };
+        case "tools/list":
+          return this.handleToolsList(request);
+        case "tools/call":
+          return this.handleToolsCall(request);
+        case "ping":
+          return {
+            jsonrpc: "2.0",
+            id: request.id,
+            result: {}
+          };
+        default:
+          return {
+            jsonrpc: "2.0",
+            id: request.id,
+            error: {
+              code: MCP_ERRORS.METHOD_NOT_FOUND,
+              message: `Unknown method: ${request.method}`
+            }
+          };
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (this.config.debug) {
+        console.error("[MCP DEBUG] Handler error:", message);
+      }
+      return {
+        jsonrpc: "2.0",
+        id: request.id,
+        error: {
+          code: MCP_ERRORS.INTERNAL_ERROR,
+          message: `Internal error: ${message}`
+        }
+      };
+    }
+  }
+  /**
+   * Handle initialize request
+   */
+  async handleInitialize(request) {
+    if (this.config.debug) {
+      console.error("[MCP DEBUG] Initialize request from client");
+    }
+    return {
+      jsonrpc: "2.0",
+      id: request.id,
+      result: {
+        protocolVersion: "2024-11-05",
+        serverInfo: SERVER_INFO,
+        capabilities: SERVER_CAPABILITIES
+      }
+    };
+  }
+  /**
+   * Handle tools/list request
+   */
+  async handleToolsList(request) {
+    try {
+      const result = await this.client.listTools();
+      return {
+        jsonrpc: "2.0",
+        id: request.id,
+        result
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        jsonrpc: "2.0",
+        id: request.id,
+        error: {
+          code: MCP_ERRORS.INTERNAL_ERROR,
+          message: `Failed to list tools: ${message}`
+        }
+      };
+    }
+  }
+  /**
+   * Handle tools/call request
+   */
+  async handleToolsCall(request) {
+    const params = request.params;
+    if (!params?.name) {
+      return {
+        jsonrpc: "2.0",
+        id: request.id,
+        error: {
+          code: MCP_ERRORS.INVALID_PARAMS,
+          message: "Missing tool name in params"
+        }
+      };
+    }
+    try {
+      const result = await this.client.callTool(params.name, params.arguments ?? {});
+      return {
+        jsonrpc: "2.0",
+        id: request.id,
+        result
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        jsonrpc: "2.0",
+        id: request.id,
+        error: {
+          code: MCP_ERRORS.INTERNAL_ERROR,
+          message: `Tool call failed: ${message}`
+        }
+      };
+    }
+  }
+};
+
+// src/cli.ts
+var API_KEY = process.env.FHIRFLY_API_KEY;
+var API_URL = process.env.FHIRFLY_API_URL || "https://api.fhirfly.io";
+var DEBUG = process.env.FHIRFLY_DEBUG === "1" || process.env.FHIRFLY_DEBUG === "true";
+if (!API_KEY) {
+  console.error("Error: FHIRFLY_API_KEY environment variable is required");
+  console.error("");
+  console.error("To get an API key:");
+  console.error("  1. Sign up at https://fhirfly.io");
+  console.error("  2. Go to Dashboard > Credentials");
+  console.error("  3. Create an MCP credential");
+  console.error("");
+  console.error("Then set the environment variable:");
+  console.error('  export FHIRFLY_API_KEY="your_api_key_here"');
+  console.error("");
+  console.error("Or configure in Claude Desktop's claude_desktop_config.json");
+  process.exit(1);
+}
+if (!API_KEY.startsWith("ffly_")) {
+  console.error("Error: Invalid API key format");
+  console.error("FHIRfly API keys start with 'ffly_'");
+  console.error("");
+  console.error("Please check your FHIRFLY_API_KEY environment variable.");
+  process.exit(1);
+}
+if (DEBUG) {
+  console.error("=".repeat(50));
+  console.error("FHIRfly MCP Server - Debug Mode");
+  console.error("=".repeat(50));
+  console.error("API URL:", API_URL);
+  console.error("API Key:", API_KEY.slice(0, 15) + "...");
+  console.error("=".repeat(50));
+}
+var server = new McpServer({
+  apiKey: API_KEY,
+  apiUrl: API_URL,
+  debug: DEBUG
+});
+server.start();
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport.ts","../src/client.ts","../src/server.ts","../src/cli.ts"],"names":[],"mappings":"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","file":"cli.js","sourcesContent":["/**\n * MCP Stdio Transport\n * Handles JSON-RPC communication over stdin/stdout\n */\n\nimport { createInterface } from \"readline\";\nimport type { JsonRpcRequest, JsonRpcResponse } from \"./types.js\";\n\nexport type MessageHandler = (request: JsonRpcRequest) => Promise<JsonRpcResponse>;\n\nexport class StdioTransport {\n  private handler: MessageHandler | null = null;\n  private debug: boolean;\n  private pendingRequests: number = 0;\n  private stdinClosed: boolean = false;\n\n  constructor(debug: boolean = false) {\n    this.debug = debug;\n  }\n\n  /**\n   * Set the handler for incoming messages\n   */\n  setHandler(handler: MessageHandler): void {\n    this.handler = handler;\n  }\n\n  /**\n   * Start listening for messages on stdin\n   */\n  start(): void {\n    const rl = createInterface({\n      input: process.stdin,\n      output: process.stdout,\n      terminal: false,\n    });\n\n    // Buffer for accumulating partial messages\n    let buffer = \"\";\n\n    rl.on(\"line\", async (line) => {\n      buffer += line;\n\n      // Try to parse as JSON\n      try {\n        const request = JSON.parse(buffer) as JsonRpcRequest;\n        buffer = \"\"; // Clear buffer on successful parse\n\n        if (this.debug) {\n          console.error(\"[MCP DEBUG] Received:\", JSON.stringify(request, null, 2));\n        }\n\n        if (this.handler) {\n          this.pendingRequests++;\n          try {\n            const response = await this.handler(request);\n            this.send(response);\n          } finally {\n            this.pendingRequests--;\n            this.maybeExit();\n          }\n        }\n      } catch {\n        // If parse fails, might be partial message - keep buffering\n        // Unless it looks like a complete but invalid message\n        if (line.trim().endsWith(\"}\")) {\n          this.sendError(null, -32700, \"Parse error: Invalid JSON\");\n          buffer = \"\";\n        }\n      }\n    });\n\n    rl.on(\"close\", () => {\n      this.stdinClosed = true;\n      if (this.debug) {\n        console.error(\"[MCP DEBUG] stdin closed, waiting for pending requests...\");\n      }\n      this.maybeExit();\n    });\n\n    // Handle errors gracefully\n    process.stdin.on(\"error\", (err) => {\n      if (this.debug) {\n        console.error(\"[MCP DEBUG] stdin error:\", err.message);\n      }\n    });\n  }\n\n  /**\n   * Exit if stdin is closed and no pending requests\n   */\n  private maybeExit(): void {\n    if (this.stdinClosed && this.pendingRequests === 0) {\n      if (this.debug) {\n        console.error(\"[MCP DEBUG] All requests complete, exiting\");\n      }\n      process.exit(0);\n    }\n  }\n\n  /**\n   * Send a JSON-RPC response to stdout\n   */\n  send(response: JsonRpcResponse): void {\n    const message = JSON.stringify(response);\n\n    if (this.debug) {\n      console.error(\"[MCP DEBUG] Sending:\", JSON.stringify(response, null, 2));\n    }\n\n    // Write to stdout with newline\n    process.stdout.write(message + \"\\n\");\n  }\n\n  /**\n   * Send an error response\n   */\n  sendError(id: string | number | null, code: number, message: string, data?: unknown): void {\n    this.send({\n      jsonrpc: \"2.0\",\n      id,\n      error: {\n        code,\n        message,\n        data,\n      },\n    });\n  }\n}\n","/**\n * FHIRfly API Client\n * Makes HTTP requests to the FHIRfly MCP endpoint\n */\n\nimport type {\n  JsonRpcRequest,\n  JsonRpcResponse,\n  McpServerConfig,\n  McpToolsListResult,\n  McpToolCallResult,\n} from \"./types.js\";\n\nexport class FhirflyClient {\n  private config: McpServerConfig;\n\n  constructor(config: McpServerConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Send a JSON-RPC request to the FHIRfly MCP endpoint\n   */\n  async request(method: string, params?: Record<string, unknown>): Promise<JsonRpcResponse> {\n    const requestBody: JsonRpcRequest = {\n      jsonrpc: \"2.0\",\n      id: Date.now(),\n      method,\n      params,\n    };\n\n    if (this.config.debug) {\n      console.error(`[MCP DEBUG] API Request: ${method}`, params);\n    }\n\n    try {\n      const response = await fetch(`${this.config.apiUrl}/mcp`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"x-api-key\": this.config.apiKey,\n          \"User-Agent\": \"@fhirfly-io/mcp-server\",\n        },\n        body: JSON.stringify(requestBody),\n      });\n\n      if (!response.ok) {\n        // Handle HTTP errors\n        if (response.status === 401) {\n          return {\n            jsonrpc: \"2.0\",\n            id: requestBody.id,\n            error: {\n              code: -32001,\n              message: \"Authentication failed. Check your FHIRFLY_API_KEY.\",\n            },\n          };\n        }\n\n        if (response.status === 429) {\n          return {\n            jsonrpc: \"2.0\",\n            id: requestBody.id,\n            error: {\n              code: -32002,\n              message: \"Rate limit exceeded. Please slow down requests.\",\n            },\n          };\n        }\n\n        return {\n          jsonrpc: \"2.0\",\n          id: requestBody.id,\n          error: {\n            code: -32000,\n            message: `API error: ${response.status} ${response.statusText}`,\n          },\n        };\n      }\n\n      const result = (await response.json()) as JsonRpcResponse;\n\n      if (this.config.debug) {\n        console.error(\"[MCP DEBUG] API Response:\", JSON.stringify(result, null, 2));\n      }\n\n      return result;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      if (this.config.debug) {\n        console.error(\"[MCP DEBUG] API Error:\", message);\n      }\n\n      return {\n        jsonrpc: \"2.0\",\n        id: requestBody.id,\n        error: {\n          code: -32003,\n          message: `Network error: ${message}`,\n        },\n      };\n    }\n  }\n\n  /**\n   * Get list of available tools from FHIRfly\n   */\n  async listTools(): Promise<McpToolsListResult> {\n    const response = await this.request(\"tools/list\", {});\n\n    if (response.error) {\n      throw new Error(response.error.message);\n    }\n\n    return response.result as McpToolsListResult;\n  }\n\n  /**\n   * Call a tool on the FHIRfly API\n   */\n  async callTool(name: string, args: Record<string, unknown>): Promise<McpToolCallResult> {\n    const response = await this.request(\"tools/call\", {\n      name,\n      arguments: args,\n    });\n\n    if (response.error) {\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: JSON.stringify({\n              error: response.error.message,\n              code: response.error.code,\n            }),\n          },\n        ],\n        isError: true,\n      };\n    }\n\n    return response.result as McpToolCallResult;\n  }\n}\n","/**\n * FHIRfly MCP Server\n * Main server class that handles MCP protocol messages\n */\n\nimport { StdioTransport } from \"./transport.js\";\nimport { FhirflyClient } from \"./client.js\";\nimport type {\n  JsonRpcRequest,\n  JsonRpcResponse,\n  McpServerConfig,\n  McpToolCallParams,\n} from \"./types.js\";\n\nconst MCP_ERRORS = {\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n} as const;\n\n// Server capabilities\nconst SERVER_INFO = {\n  name: \"fhirfly-mcp-server\",\n  version: \"0.1.0\",\n};\n\nconst SERVER_CAPABILITIES = {\n  tools: {},\n};\n\nexport class McpServer {\n  private transport: StdioTransport;\n  private client: FhirflyClient;\n  private config: McpServerConfig;\n  public initialized: boolean = false;\n\n  constructor(config: McpServerConfig) {\n    this.config = config;\n    this.transport = new StdioTransport(config.debug);\n    this.client = new FhirflyClient(config);\n  }\n\n  /**\n   * Start the MCP server\n   */\n  start(): void {\n    if (this.config.debug) {\n      console.error(\"[MCP DEBUG] Starting FHIRfly MCP Server\");\n      console.error(\"[MCP DEBUG] API URL:\", this.config.apiUrl);\n      console.error(\"[MCP DEBUG] API Key:\", this.config.apiKey.slice(0, 10) + \"...\");\n    }\n\n    this.transport.setHandler(this.handleMessage.bind(this));\n    this.transport.start();\n  }\n\n  /**\n   * Handle incoming JSON-RPC messages\n   */\n  private async handleMessage(request: JsonRpcRequest): Promise<JsonRpcResponse> {\n    try {\n      // Validate JSON-RPC request structure\n      if (request.jsonrpc !== \"2.0\" || !request.method) {\n        return {\n          jsonrpc: \"2.0\",\n          id: request.id ?? null,\n          error: {\n            code: MCP_ERRORS.INVALID_REQUEST,\n            message: \"Invalid JSON-RPC request\",\n          },\n        };\n      }\n\n      // Route to appropriate handler\n      switch (request.method) {\n        case \"initialize\":\n          return this.handleInitialize(request);\n\n        case \"initialized\":\n          // Client notification that initialization is complete\n          this.initialized = true;\n          return {\n            jsonrpc: \"2.0\",\n            id: request.id,\n            result: {},\n          };\n\n        case \"tools/list\":\n          return this.handleToolsList(request);\n\n        case \"tools/call\":\n          return this.handleToolsCall(request);\n\n        case \"ping\":\n          return {\n            jsonrpc: \"2.0\",\n            id: request.id,\n            result: {},\n          };\n\n        default:\n          return {\n            jsonrpc: \"2.0\",\n            id: request.id,\n            error: {\n              code: MCP_ERRORS.METHOD_NOT_FOUND,\n              message: `Unknown method: ${request.method}`,\n            },\n          };\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      if (this.config.debug) {\n        console.error(\"[MCP DEBUG] Handler error:\", message);\n      }\n\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id,\n        error: {\n          code: MCP_ERRORS.INTERNAL_ERROR,\n          message: `Internal error: ${message}`,\n        },\n      };\n    }\n  }\n\n  /**\n   * Handle initialize request\n   */\n  private async handleInitialize(request: JsonRpcRequest): Promise<JsonRpcResponse> {\n    if (this.config.debug) {\n      console.error(\"[MCP DEBUG] Initialize request from client\");\n    }\n\n    return {\n      jsonrpc: \"2.0\",\n      id: request.id,\n      result: {\n        protocolVersion: \"2024-11-05\",\n        serverInfo: SERVER_INFO,\n        capabilities: SERVER_CAPABILITIES,\n      },\n    };\n  }\n\n  /**\n   * Handle tools/list request\n   */\n  private async handleToolsList(request: JsonRpcRequest): Promise<JsonRpcResponse> {\n    try {\n      const result = await this.client.listTools();\n\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id,\n        result,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id,\n        error: {\n          code: MCP_ERRORS.INTERNAL_ERROR,\n          message: `Failed to list tools: ${message}`,\n        },\n      };\n    }\n  }\n\n  /**\n   * Handle tools/call request\n   */\n  private async handleToolsCall(request: JsonRpcRequest): Promise<JsonRpcResponse> {\n    const params = request.params as McpToolCallParams | undefined;\n\n    if (!params?.name) {\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id,\n        error: {\n          code: MCP_ERRORS.INVALID_PARAMS,\n          message: \"Missing tool name in params\",\n        },\n      };\n    }\n\n    try {\n      const result = await this.client.callTool(params.name, params.arguments ?? {});\n\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id,\n        result,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id,\n        error: {\n          code: MCP_ERRORS.INTERNAL_ERROR,\n          message: `Tool call failed: ${message}`,\n        },\n      };\n    }\n  }\n}\n","/**\n * FHIRfly MCP Server CLI\n * Entry point for running as an MCP server\n */\n\nimport { McpServer } from \"./server.js\";\n\n// Configuration from environment\nconst API_KEY = process.env.FHIRFLY_API_KEY;\nconst API_URL = process.env.FHIRFLY_API_URL || \"https://api.fhirfly.io\";\nconst DEBUG = process.env.FHIRFLY_DEBUG === \"1\" || process.env.FHIRFLY_DEBUG === \"true\";\n\n// Validate required configuration\nif (!API_KEY) {\n  console.error(\"Error: FHIRFLY_API_KEY environment variable is required\");\n  console.error(\"\");\n  console.error(\"To get an API key:\");\n  console.error(\"  1. Sign up at https://fhirfly.io\");\n  console.error(\"  2. Go to Dashboard > Credentials\");\n  console.error(\"  3. Create an MCP credential\");\n  console.error(\"\");\n  console.error(\"Then set the environment variable:\");\n  console.error('  export FHIRFLY_API_KEY=\"your_api_key_here\"');\n  console.error(\"\");\n  console.error(\"Or configure in Claude Desktop's claude_desktop_config.json\");\n  process.exit(1);\n}\n\n// Validate API key format\nif (!API_KEY.startsWith(\"ffly_\")) {\n  console.error(\"Error: Invalid API key format\");\n  console.error(\"FHIRfly API keys start with 'ffly_'\");\n  console.error(\"\");\n  console.error(\"Please check your FHIRFLY_API_KEY environment variable.\");\n  process.exit(1);\n}\n\nif (DEBUG) {\n  console.error(\"=\".repeat(50));\n  console.error(\"FHIRfly MCP Server - Debug Mode\");\n  console.error(\"=\".repeat(50));\n  console.error(\"API URL:\", API_URL);\n  console.error(\"API Key:\", API_KEY.slice(0, 15) + \"...\");\n  console.error(\"=\".repeat(50));\n}\n\n// Create and start server\nconst server = new McpServer({\n  apiKey: API_KEY,\n  apiUrl: API_URL,\n  debug: DEBUG,\n});\n\nserver.start();\n"]}