Healthcare Document Management MCP Server

A healthcare document management server built using the Model Context Protocol (MCP).

This project exposes healthcare document-management capabilities to an MCP-capable AI client through typed MCP tools. The server works with a synthetic healthcare document repository and demonstrates searching and saving document metadata through MCP.

Important: This project uses only synthetic and fictional healthcare data. It does not use real patient information.

Project Overview

The Healthcare Document Management MCP Server provides two MCP tools:

1. search_patient_document

   • Searches the synthetic healthcare document repository.

   • Accepts a patient ID and document type.

   • Returns matching document metadata.

2. save_document_metadata

   • Saves metadata for a new synthetic healthcare document.

   • Accepts typed document metadata fields.

   • Validates the supplied information before modifying the repository.

The server is connected to an MCP-capable AI client in VS Code and was tested end to end.

Architecture

MCP-capable AI Client
        |
        | Model Context Protocol (MCP)
        v
Healthcare Document Management MCP Server
        |
        +-----------------------------+
        |                             |
        v                             v
search_patient_document       save_document_metadata
        |                             |
        +-------------+---------------+
                      |
                      v
        Synthetic Healthcare
        Document Repository
        (document_metadata.json)
        

## Setup

### Requirements

- Python 3.11+
- uv
- Git
- VS Code with an MCP-capable AI client

### Install

Clone the repository and open the project folder:

```powershell
git clone https://github.com/prathimanr-wq/healthcare-document-mcp.git
cd healthcare-document-mcp