# 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

```text
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