mcp-fhir-patient-index

Shaumik-Ashraf/mcp-fhir-patient-index

3.2

If you are the rightful owner of mcp-fhir-patient-index and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Model Context Protocol (MCP) server is designed to facilitate seamless integration with Large Language Models (LLMs) by providing a structured and standardized communication protocol.

MCP FHIR Patient Index

CI

⚠️ Development in progress

A master patient index in Rails 8 with a conformant FHIR API and Model Context Protocol (MCP) for LLM integration.

Features

  • Built-in MCP server
  • Built-in minimalistic FHIR server
  • Create, read, update, and destroy patients
  • User friendly and customizable UI

Constraints

  • Supports US (en-speaking) patients only (no I18n)
  • Supports FHIR R4 only

This app has is not ready for real-patient data out of the box. For real-world use, you must regenerate credentials, and do a secure deployment with SOC-II compliance.

Dependencies

Developer Start

  1. yarn install
  2. bundle
  3. rails db:migrate
  4. rails assets:precompile
  5. rails server

Documentation

Dev Tools

  • bundle exec rspec: run tests
  • bundle exec rubocop: run linter
  • ./bin/brakeman: run security scan

Testing FHIR with Inferno

See

Testing MCP

I'm testing MCP with the official inspector:

  1. If you have npm installed run:
npx @modelcontextprotocol/inspector

OR if you have docker run:

docker run --rm --network host -p 6274:6274 -p 6277:6277 ghcr.io/modelcontextprotocol/inspector:latest
  1. Open its web UI and use settings:

Transport Type: Streamable HTTP

URL: http://localhost:3000/mcp/v20250618

and press Connect.

Tech Stack

Rails 8 with SQLite3, ESBuild, Bootstrap 5.3, and all other default options, except JBuilder and ActionMailbox which were excluded.

License

Copyright © 2025 Shaumik Ashraf

This project is under the MIT License. You can view the license at LICENSE.txt.

Trademark Notice

HL7, FHIR and the FHIR [FLAME DESIGN] are the registered trademarks of Health Level Seven International and their use does not constitute endorsement by HL7.