Skip to main content

Installation

Clone the project into any location that works for your environment.

Guided Setup​

On Windows, double-click:

Install Oscar EMR MCP.cmd

On macOS/Linux, run:

./scripts/install_oscar_emr_mcp_unix.sh

The guided setup installs dependencies, opens the database wizard, prepares Codex Desktop, and registers Cursor when a database config exists.

Windows PowerShell​

git clone https://github.com/rahulsharmaah/oscaremr-mcp.git
cd oscaremr-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

macOS / Linux​

git clone https://github.com/rahulsharmaah/oscaremr-mcp.git
cd oscaremr-mcp
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

Verify the Install​

Run the unit tests:

pytest

Run the server module:

python -m oscar_db_mcp.server

The server uses stdio for MCP traffic. If it appears to wait quietly, that is expected.

Command-Line Entry Points​

After installation, these commands are available inside the virtual environment:

oscar-db-mcp
oscar-db-mcp-configure --interactive