dhis2-mcp

Un servidor MCP de solo lectura para datos de salud de DHIS2. Se ejecuta en stdio.

El servidor está construido para modelos locales pequeños. Cada herramienta devuelve JSON compacto, no la respuesta bruta de DHIS2. Una ventana de contexto pequeña es un presupuesto — las herramientas gastan de ella lo menos posible.

Herramientas

Ejecuta primero search_indicators para obtener el id de un indicador. Después, pásalo a query_analytics.

Related MCP server: WHO MCP Server

Requisitos

• Node.js 20 o posterior.

• Una instancia de DHIS2. La predeterminada es la demo pública de play, así que puedes empezar sin configuración.

Instalación y compilación

git clone https://github.com/brianmituka/dhis2-mcp.git
cd dhis2-mcp
npm install
npm run build

Configuración

Define estas variables de entorno. Las tres son opcionales.

La demo de play se restablece cada noche. Usa el host play.im.dhis2.org, no play.dhis2.org — el host anterior redirige a una página HTML.

Uso con LM Studio

LM Studio 0.3.17 o posterior admite MCP. Abre la pestaña Program y edita mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "dhis2": {
      "command": "node",
      "args": ["/absolute/path/to/dhis2-mcp/dist/index.js"],
      "env": {
        "DHIS2_BASE_URL": "https://play.im.dhis2.org/stable-2-43-1",
        "DHIS2_USERNAME": "admin",
        "DHIS2_PASSWORD": "district"
      }
    }
  }
}

Reemplaza la ruta con la ubicación de tu clon. Reinicia el chat del modelo después de editar el archivo.

Uso con otros clientes MCP

Cualquier cliente MCP que funcione con stdio es válido. Para Claude Code:

claude mcp add dhis2 -- node /absolute/path/to/dhis2-mcp/dist/index.js

Probar con MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

El Inspector no recarga el servidor después de una recompilación. Haz clic en Restart en el Inspector después de cada npm run build.

Licencia

MIT. Consulta LICENSE.