fhir-mcp-server-medagentbench

A Python-based MCP (MedAgentBench Communications Protocol) server designed for the MedAgentBench environment. This server simulates interactions with a FHIR (Fast Healthcare Interoperability Resources) API.

Instead of making actual HTTP requests to a FHIR server, it intercepts MCP requests for FHIR operations and returns a textual representation of the HTTP request that would have been made (e.g., GET https://fhir.example.com/Patient/123 or POST https://fhir.example.com/Observation\n{...}). This allows testing MedAgentBench agents without needing a live FHIR endpoint.

Features

Implements MCP handlers:
list_resources: Lists available simulated resources (currently CapabilityStatement).
read_resource: Simulates reading a FHIR resource by its URI.
list_tools: Lists available FHIR simulation tools.
call_tool: Simulates executing FHIR operations:
search_fhir: Simulates searching for FHIR resources.
read_fhir: Simulates reading a specific FHIR resource by URI.
create_fhir_resource: Simulates creating a new FHIR resource.
Uses mcp-server library for MCP communication.
Configured and packaged using Poetry.

• Includes asynchronous unit tests with pytest and pytest-asyncio.

Installation

Ensure you have Python >= 3.10 and Poetry installed.

poetry install

Configuration

Before running the server, you must set the FHIR_BASE_URL environment variable. This URL is used to construct the simulated request strings.

```bash
export FHIR_BASE_URL="https://your-fhir-server-base.com/fhir"