@fhirfly-io/mcp-server 0.1.0

package/dist/index.cjs

@@ -0,0 +1,397 @@
+'use strict';
+
+var readline = require('readline');
+
+// src/transport.ts
+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 = readline.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}`
+        }
+      };
+    }
+  }
+};
+
+exports.FhirflyClient = FhirflyClient;
+exports.McpServer = McpServer;
+exports.StdioTransport = StdioTransport;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport.ts","../src/client.ts","../src/server.ts"],"names":["createInterface"],"mappings":";;;;;AAUO,IAAM,iBAAN,MAAqB;AAAA,EAClB,OAAA,GAAiC,IAAA;AAAA,EACjC,KAAA;AAAA,EACA,eAAA,GAA0B,CAAA;AAAA,EAC1B,WAAA,GAAuB,KAAA;AAAA,EAE/B,WAAA,CAAY,QAAiB,KAAA,EAAO;AAClC,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,OAAA,EAA+B;AACxC,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,MAAM,KAAKA,wBAAA,CAAgB;AAAA,MACzB,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,QAAA,EAAU;AAAA,KACX,CAAA;AAGD,IAAA,IAAI,MAAA,GAAS,EAAA;AAEb,IAAA,EAAA,CAAG,EAAA,CAAG,MAAA,EAAQ,OAAO,IAAA,KAAS;AAC5B,MAAA,MAAA,IAAU,IAAA;AAGV,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,MAAM,CAAA;AACjC,QAAA,MAAA,GAAS,EAAA;AAET,QAAA,IAAI,KAAK,KAAA,EAAO;AACd,UAAA,OAAA,CAAQ,MAAM,uBAAA,EAAyB,IAAA,CAAK,UAAU,OAAA,EAAS,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,QACzE;AAEA,QAAA,IAAI,KAAK,OAAA,EAAS;AAChB,UAAA,IAAA,CAAK,eAAA,EAAA;AACL,UAAA,IAAI;AACF,YAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC3C,YAAA,IAAA,CAAK,KAAK,QAAQ,CAAA;AAAA,UACpB,CAAA,SAAE;AACA,YAAA,IAAA,CAAK,eAAA,EAAA;AACL,YAAA,IAAA,CAAK,SAAA,EAAU;AAAA,UACjB;AAAA,QACF;AAAA,MACF,CAAA,CAAA,MAAQ;AAGN,QAAA,IAAI,IAAA,CAAK,IAAA,EAAK,CAAE,QAAA,CAAS,GAAG,CAAA,EAAG;AAC7B,UAAA,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,MAAA,EAAQ,2BAA2B,CAAA;AACxD,UAAA,MAAA,GAAS,EAAA;AAAA,QACX;AAAA,MACF;AAAA,IACF,CAAC,CAAA;AAED,IAAA,EAAA,CAAG,EAAA,CAAG,SAAS,MAAM;AACnB,MAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,MAAA,IAAI,KAAK,KAAA,EAAO;AACd,QAAA,OAAA,CAAQ,MAAM,2DAA2D,CAAA;AAAA,MAC3E;AACA,MAAA,IAAA,CAAK,SAAA,EAAU;AAAA,IACjB,CAAC,CAAA;AAGD,IAAA,OAAA,CAAQ,KAAA,CAAM,EAAA,CAAG,OAAA,EAAS,CAAC,GAAA,KAAQ;AACjC,MAAA,IAAI,KAAK,KAAA,EAAO;AACd,QAAA,OAAA,CAAQ,KAAA,CAAM,0BAAA,EAA4B,GAAA,CAAI,OAAO,CAAA;AAAA,MACvD;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,SAAA,GAAkB;AACxB,IAAA,IAAI,IAAA,CAAK,WAAA,IAAe,IAAA,CAAK,eAAA,KAAoB,CAAA,EAAG;AAClD,MAAA,IAAI,KAAK,KAAA,EAAO;AACd,QAAA,OAAA,CAAQ,MAAM,4CAA4C,CAAA;AAAA,MAC5D;AACA,MAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,KAAK,QAAA,EAAiC;AACpC,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA;AAEvC,IAAA,IAAI,KAAK,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,MAAM,sBAAA,EAAwB,IAAA,CAAK,UAAU,QAAA,EAAU,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,IACzE;AAGA,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,OAAA,GAAU,IAAI,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,SAAA,CAAU,EAAA,EAA4B,IAAA,EAAc,OAAA,EAAiB,IAAA,EAAsB;AACzF,IAAA,IAAA,CAAK,IAAA,CAAK;AAAA,MACR,OAAA,EAAS,KAAA;AAAA,MACT,EAAA;AAAA,MACA,KAAA,EAAO;AAAA,QACL,IAAA;AAAA,QACA,OAAA;AAAA,QACA;AAAA;AACF,KACD,CAAA;AAAA,EACH;AACF;;;ACnHO,IAAM,gBAAN,MAAoB;AAAA,EACjB,MAAA;AAAA,EAER,YAAY,MAAA,EAAyB;AACnC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAA,CAAQ,MAAA,EAAgB,MAAA,EAA4D;AACxF,IAAA,MAAM,WAAA,GAA8B;AAAA,MAClC,OAAA,EAAS,KAAA;AAAA,MACT,EAAA,EAAI,KAAK,GAAA,EAAI;AAAA,MACb,MAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AACrB,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,yBAAA,EAA4B,MAAM,CAAA,CAAA,EAAI,MAAM,CAAA;AAAA,IAC5D;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,WAAW,MAAM,KAAA,CAAM,GAAG,IAAA,CAAK,MAAA,CAAO,MAAM,CAAA,IAAA,CAAA,EAAQ;AAAA,QACxD,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,cAAA,EAAgB,kBAAA;AAAA,UAChB,WAAA,EAAa,KAAK,MAAA,CAAO,MAAA;AAAA,UACzB,YAAA,EAAc;AAAA,SAChB;AAAA,QACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,WAAW;AAAA,OACjC,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAEhB,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,IAAI,WAAA,CAAY,EAAA;AAAA,YAChB,KAAA,EAAO;AAAA,cACL,IAAA,EAAM,CAAA,KAAA;AAAA,cACN,OAAA,EAAS;AAAA;AACX,WACF;AAAA,QACF;AAEA,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,IAAI,WAAA,CAAY,EAAA;AAAA,YAChB,KAAA,EAAO;AAAA,cACL,IAAA,EAAM,CAAA,KAAA;AAAA,cACN,OAAA,EAAS;AAAA;AACX,WACF;AAAA,QACF;AAEA,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,IAAI,WAAA,CAAY,EAAA;AAAA,UAChB,KAAA,EAAO;AAAA,YACL,IAAA,EAAM,CAAA,IAAA;AAAA,YACN,SAAS,CAAA,WAAA,EAAc,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,UAAU,CAAA;AAAA;AAC/D,SACF;AAAA,MACF;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AACrB,QAAA,OAAA,CAAQ,MAAM,2BAAA,EAA6B,IAAA,CAAK,UAAU,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,MAC5E;AAEA,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAErE,MAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AACrB,QAAA,OAAA,CAAQ,KAAA,CAAM,0BAA0B,OAAO,CAAA;AAAA,MACjD;AAEA,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,WAAA,CAAY,EAAA;AAAA,QAChB,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,MAAA;AAAA,UACN,OAAA,EAAS,kBAAkB,OAAO,CAAA;AAAA;AACpC,OACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAA,GAAyC;AAC7C,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,YAAA,EAAc,EAAE,CAAA;AAEpD,IAAA,IAAI,SAAS,KAAA,EAAO;AAClB,MAAA,MAAM,IAAI,KAAA,CAAM,QAAA,CAAS,KAAA,CAAM,OAAO,CAAA;AAAA,IACxC;AAEA,IAAA,OAAO,QAAA,CAAS,MAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAA,CAAS,IAAA,EAAc,IAAA,EAA2D;AACtF,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,YAAA,EAAc;AAAA,MAChD,IAAA;AAAA,MACA,SAAA,EAAW;AAAA,KACZ,CAAA;AAED,IAAA,IAAI,SAAS,KAAA,EAAO;AAClB,MAAA,OAAO;AAAA,QACL,OAAA,EAAS;AAAA,UACP;AAAA,YACE,IAAA,EAAM,MAAA;AAAA,YACN,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,cACnB,KAAA,EAAO,SAAS,KAAA,CAAM,OAAA;AAAA,cACtB,IAAA,EAAM,SAAS,KAAA,CAAM;AAAA,aACtB;AAAA;AACH,SACF;AAAA,QACA,OAAA,EAAS;AAAA,OACX;AAAA,IACF;AAEA,IAAA,OAAO,QAAA,CAAS,MAAA;AAAA,EAClB;AACF;;;AClIA,IAAM,UAAA,GAAa;AAAA,EACjB,WAAA,EAAa,MAAA;AAAA,EACb,eAAA,EAAiB,MAAA;AAAA,EACjB,gBAAA,EAAkB,MAAA;AAAA,EAClB,cAAA,EAAgB,MAAA;AAAA,EAChB,cAAA,EAAgB;AAClB,CAAA;AAGA,IAAM,WAAA,GAAc;AAAA,EAClB,IAAA,EAAM,oBAAA;AAAA,EACN,OAAA,EAAS;AACX,CAAA;AAEA,IAAM,mBAAA,GAAsB;AAAA,EAC1B,OAAO;AACT,CAAA;AAEO,IAAM,YAAN,MAAgB;AAAA,EACb,SAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AAAA,EACD,WAAA,GAAuB,KAAA;AAAA,EAE9B,YAAY,MAAA,EAAyB;AACnC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,cAAA,CAAe,MAAA,CAAO,KAAK,CAAA;AAChD,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,aAAA,CAAc,MAAM,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AACrB,MAAA,OAAA,CAAQ,MAAM,yCAAyC,CAAA;AACvD,MAAA,OAAA,CAAQ,KAAA,CAAM,sBAAA,EAAwB,IAAA,CAAK,MAAA,CAAO,MAAM,CAAA;AACxD,MAAA,OAAA,CAAQ,KAAA,CAAM,wBAAwB,IAAA,CAAK,MAAA,CAAO,OAAO,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,KAAK,CAAA;AAAA,IAC/E;AAEA,IAAA,IAAA,CAAK,UAAU,UAAA,CAAW,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,IAAI,CAAC,CAAA;AACvD,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,cAAc,OAAA,EAAmD;AAC7E,IAAA,IAAI;AAEF,MAAA,IAAI,OAAA,CAAQ,OAAA,KAAY,KAAA,IAAS,CAAC,QAAQ,MAAA,EAAQ;AAChD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,EAAA,EAAI,QAAQ,EAAA,IAAM,IAAA;AAAA,UAClB,KAAA,EAAO;AAAA,YACL,MAAM,UAAA,CAAW,eAAA;AAAA,YACjB,OAAA,EAAS;AAAA;AACX,SACF;AAAA,MACF;AAGA,MAAA,QAAQ,QAAQ,MAAA;AAAQ,QACtB,KAAK,YAAA;AACH,UAAA,OAAO,IAAA,CAAK,iBAAiB,OAAO,CAAA;AAAA,QAEtC,KAAK,aAAA;AAEH,UAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,IAAI,OAAA,CAAQ,EAAA;AAAA,YACZ,QAAQ;AAAC,WACX;AAAA,QAEF,KAAK,YAAA;AACH,UAAA,OAAO,IAAA,CAAK,gBAAgB,OAAO,CAAA;AAAA,QAErC,KAAK,YAAA;AACH,UAAA,OAAO,IAAA,CAAK,gBAAgB,OAAO,CAAA;AAAA,QAErC,KAAK,MAAA;AACH,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,IAAI,OAAA,CAAQ,EAAA;AAAA,YACZ,QAAQ;AAAC,WACX;AAAA,QAEF;AACE,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,IAAI,OAAA,CAAQ,EAAA;AAAA,YACZ,KAAA,EAAO;AAAA,cACL,MAAM,UAAA,CAAW,gBAAA;AAAA,cACjB,OAAA,EAAS,CAAA,gBAAA,EAAmB,OAAA,CAAQ,MAAM,CAAA;AAAA;AAC5C,WACF;AAAA;AACJ,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAErE,MAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AACrB,QAAA,OAAA,CAAQ,KAAA,CAAM,8BAA8B,OAAO,CAAA;AAAA,MACrD;AAEA,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,KAAA,EAAO;AAAA,UACL,MAAM,UAAA,CAAW,cAAA;AAAA,UACjB,OAAA,EAAS,mBAAmB,OAAO,CAAA;AAAA;AACrC,OACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,iBAAiB,OAAA,EAAmD;AAChF,IAAA,IAAI,IAAA,CAAK,OAAO,KAAA,EAAO;AACrB,MAAA,OAAA,CAAQ,MAAM,4CAA4C,CAAA;AAAA,IAC5D;AAEA,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,KAAA;AAAA,MACT,IAAI,OAAA,CAAQ,EAAA;AAAA,MACZ,MAAA,EAAQ;AAAA,QACN,eAAA,EAAiB,YAAA;AAAA,QACjB,UAAA,EAAY,WAAA;AAAA,QACZ,YAAA,EAAc;AAAA;AAChB,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,gBAAgB,OAAA,EAAmD;AAC/E,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,MAAA,CAAO,SAAA,EAAU;AAE3C,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAErE,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,KAAA,EAAO;AAAA,UACL,MAAM,UAAA,CAAW,cAAA;AAAA,UACjB,OAAA,EAAS,yBAAyB,OAAO,CAAA;AAAA;AAC3C,OACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,gBAAgB,OAAA,EAAmD;AAC/E,IAAA,MAAM,SAAS,OAAA,CAAQ,MAAA;AAEvB,IAAA,IAAI,CAAC,QAAQ,IAAA,EAAM;AACjB,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,KAAA,EAAO;AAAA,UACL,MAAM,UAAA,CAAW,cAAA;AAAA,UACjB,OAAA,EAAS;AAAA;AACX,OACF;AAAA,IACF;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,OAAO,IAAA,EAAM,MAAA,CAAO,SAAA,IAAa,EAAE,CAAA;AAE7E,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAErE,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,KAAA,EAAO;AAAA,UACL,MAAM,UAAA,CAAW,cAAA;AAAA,UACjB,OAAA,EAAS,qBAAqB,OAAO,CAAA;AAAA;AACvC,OACF;AAAA,IACF;AAAA,EACF;AACF","file":"index.cjs","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"]}

package/dist/index.d.cts

@@ -0,0 +1,142 @@
+/**
+ * MCP Protocol Types
+ * Based on Model Context Protocol specification
+ */
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+interface McpToolsListResult {
+    tools: McpToolDefinition[];
+}
+interface McpToolCallParams {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+interface McpToolCallResult {
+    content: Array<{
+        type: "text" | "image" | "resource";
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError?: boolean;
+}
+interface McpServerConfig {
+    apiKey: string;
+    apiUrl: string;
+    debug: boolean;
+}
+
+/**
+ * FHIRfly MCP Server
+ * Main server class that handles MCP protocol messages
+ */
+
+declare class McpServer {
+    private transport;
+    private client;
+    private config;
+    initialized: boolean;
+    constructor(config: McpServerConfig);
+    /**
+     * Start the MCP server
+     */
+    start(): void;
+    /**
+     * Handle incoming JSON-RPC messages
+     */
+    private handleMessage;
+    /**
+     * Handle initialize request
+     */
+    private handleInitialize;
+    /**
+     * Handle tools/list request
+     */
+    private handleToolsList;
+    /**
+     * Handle tools/call request
+     */
+    private handleToolsCall;
+}
+
+/**
+ * FHIRfly API Client
+ * Makes HTTP requests to the FHIRfly MCP endpoint
+ */
+
+declare class FhirflyClient {
+    private config;
+    constructor(config: McpServerConfig);
+    /**
+     * Send a JSON-RPC request to the FHIRfly MCP endpoint
+     */
+    request(method: string, params?: Record<string, unknown>): Promise<JsonRpcResponse>;
+    /**
+     * Get list of available tools from FHIRfly
+     */
+    listTools(): Promise<McpToolsListResult>;
+    /**
+     * Call a tool on the FHIRfly API
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<McpToolCallResult>;
+}
+
+/**
+ * MCP Stdio Transport
+ * Handles JSON-RPC communication over stdin/stdout
+ */
+
+type MessageHandler = (request: JsonRpcRequest) => Promise<JsonRpcResponse>;
+declare class StdioTransport {
+    private handler;
+    private debug;
+    private pendingRequests;
+    private stdinClosed;
+    constructor(debug?: boolean);
+    /**
+     * Set the handler for incoming messages
+     */
+    setHandler(handler: MessageHandler): void;
+    /**
+     * Start listening for messages on stdin
+     */
+    start(): void;
+    /**
+     * Exit if stdin is closed and no pending requests
+     */
+    private maybeExit;
+    /**
+     * Send a JSON-RPC response to stdout
+     */
+    send(response: JsonRpcResponse): void;
+    /**
+     * Send an error response
+     */
+    sendError(id: string | number | null, code: number, message: string, data?: unknown): void;
+}
+
+export { FhirflyClient, type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, McpServer, type McpServerConfig, type McpToolCallParams, type McpToolCallResult, type McpToolDefinition, type McpToolsListResult, StdioTransport };