DHIS2

You have a Model Context Protocol (MCP) server tailored for DHIS2 development and management. It offers a wide range of tools to generate code, scaffold projects, diagnose issues, and explore APIs, helping you learn DHIS2 development patterns and accelerate prototype workflows.

How to use

You can run the MCP server locally for development or use an npm-based invocation to access it through your MCP client. Use the local development flow to iterate on code generation, debugging helpers, and documentation access, and use the npx-based flow to connect from your MCP client without installing the server globally.

How to install

Prerequisites you need before installation are Node.js 18 or newer and an MCP client (such as Claude Code or Claude Desktop). You may run tools without a DHIS2 instance, but some API-related tools require a live DHIS2 connection.

# Option 1: Local Development
# Clone the project and install dependencies
git clone https://github.com/yourusername/dhis2-mcp.git
cd dhis2-mcp
npm install
npm run build

# Start in watch/dev mode (as described in the development setup)
npm run dev

Configuration and how to run from MCP clients

You can run the MCP server from MCP clients using either a local stdio command or an npm-based invocation. The following configurations show common ways to start the server from a client.

{
  "mcpServers": {
    "dhis2_mcp_local": {
      "command": "npm",
      "args": ["run", "dev"]
    },
    "dhis2_mcp_npx": {
      "command": "npx",
      "args": ["-y", "dhis2-mcp"]
    }
  }
}

Usage examples

Initialize a DHIS2 web app scaffold using the code generator tool. This starts from a project name, title, and template. You can tailor the inputs to your project needs.

{
  "tool": "dhis2_init_webapp",
  "appName": "health-tracker",
  "appTitle": "Health Tracker",
  "appType": "app",
  "typescript": true,
  "template": "basic"
}

Notes on running locally

For a local development workflow, you will typically clone the project, install dependencies, build, and then start in watch mode. This enables you to iterate on code generation, debugging helpers, and documentation tooling as you work.

# Development setup steps you might follow
git clone https://github.com/yourusername/dhis2-mcp.git
cd dhis2-mcp
npm install
npm run dev  # Watch mode for active development

Available tools

dhis2_init_webapp

Generates a web app scaffold for DHIS2 with TypeScript, a chosen template, and app structure ready for development.

dhis2_android_init_project

Creates an Android project skeleton with DHIS2 SDK integration and MVVM architecture setup.

dhis2_generate_ui_form_patterns

Produces reusable UI form patterns for data capture using standard DHIS2 UI components.

dhis2_diagnose_cors_issues

Diagnoses common CORS configuration problems and suggests fixes for local and remote DHIS2 setups.

dhis2_query_documentation

Searches and retrieves documentation topics related to DHIS2 APIs and patterns for quick reference.

dhis2_android_init_project

Sets up an Android project with necessary DHIS2 SDK references and scaffolding.

dhis2_generate_ui_components

Generates common UI components and screens based on DHIS2 UI patterns.