# bahmni-mcp

MCP server for [Bahmni](https://www.bahmni.org/) — exposes the OpenMRS/Bahmni REST API as tools that Claude can call directly.

## Prerequisites

Install [uv](https://docs.astral.sh/uv/) if you don't have it:

```sh
curl -LsSf https://astral.sh/uv/install.sh | sh
```

## Setup

Add this to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "bahmni": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lingeswaranTW/bahmni-mcp-server.git",
        "bahmni-mcp"
      ],
      "env": {
        "BAHMNI_URL": "https://your-bahmni-instance/openmrs/ws",
        "BAHMNI_USER": "your_username",
        "BAHMNI_PASSWORD": "your_password"
      }
    }
  }
}
```

> **Claude Code users:** edit `~/.claude.json` and add the same `mcpServers` block.

Restart Claude Desktop. No files to download — `uvx` fetches and runs the server automatically.

## Environment Variables

| Variable | Description |
|---|---|
| `BAHMNI_URL` | Base URL of your Bahmni instance (e.g. `https://bahmni.example.com/openmrs/ws`) |
| `BAHMNI_USER` | Bahmni username |
| `BAHMNI_PASSWORD` | Bahmni password |