DHIS2 MCP Server

Instructions

Implementation Reference

• src/android-generators.ts:842-934 (handler)

  Main handler function that generates comprehensive Android location services configuration for DHIS2 apps, including permissions, LocationManager implementation, geofencing, offline mapping, and usage examples.
  export function generateLocationServicesConfig(args: any): string { const { locationAccuracy, permissions, geofencing, coordinateCapture, offlineMapping } = args; return `# DHIS2 Android Location Services Configuration ## Location Accuracy: ${locationAccuracy.toUpperCase()} ${generateLocationServiceImplementation(locationAccuracy, permissions, geofencing, coordinateCapture, offlineMapping)} ## AndroidManifest.xml Permissions \`\`\`xml ${permissions.fineLocation ? '<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />' : ''} ${permissions.coarseLocation ? '<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />' : ''} ${permissions.backgroundLocation ? '<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />' : ''} ${offlineMapping ? '<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />' : ''} <!-- Location hardware features --> <uses-feature android:name="android.hardware.location" android:required="false" /> <uses-feature android:name="android.hardware.location.gps" android:required="false" /> \`\`\` ## Implementation ${generateLocationManagerCode(locationAccuracy, geofencing, coordinateCapture, permissions)} ${geofencing.enabled ? generateGeofencingCode(geofencing) : ''} ${offlineMapping ? generateOfflineMappingCode() : ''} ## Usage Examples \`\`\`kotlin class DataEntryActivity : AppCompatActivity() { @Inject lateinit var locationManager: DHIS2LocationManager override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // Request location permissions locationManager.requestPermissions(this) // Capture coordinates for data entry binding.captureLocationButton.setOnClickListener { captureCurrentLocation() } } private fun captureCurrentLocation() { lifecycleScope.launch { try { val location = locationManager.getCurrentLocation() // Update data element with coordinates updateCoordinateDataElement(location) } catch (e: Exception) { showLocationError(e.message) } } } private fun updateCoordinateDataElement(location: Location) { val coordinates = "\${location.latitude},\${location.longitude}" // Update DHIS2 data value with coordinates d2.dataValueModule().dataValues() .value(dataElementId, orgUnitId, periodId, categoryOptionComboId) .set(coordinates) } } \`\`\` ## Testing Location Services \`\`\`kotlin @Test fun testLocationCapture() { // Mock location for testing val mockLocation = Location("test").apply { latitude = -1.2921 longitude = 36.8219 accuracy = 5.0f } val result = locationValidator.validateLocation(mockLocation) assertTrue(result.isValid) } \`\`\` `; }
• src/index.ts:1285-1295 (registration)

  MCP server request handler registration that calls the generateLocationServicesConfig function with user arguments and returns the generated configuration.
  case 'dhis2_android_setup_location_services': const locationArgs = args as any; const locationConfig = generateLocationServicesConfig(locationArgs); return { content: [ { type: 'text', text: locationConfig, }, ], };
• src/permission-system.ts:159-159 (registration)

  Tool permission registration mapping the tool to require 'canUseMobileFeatures' permission.
  ['dhis2_android_setup_location_services', 'canUseMobileFeatures'],
• src/android-generators.ts:958-1034 (helper)

  Helper function generating the core DHIS2LocationManager Kotlin class implementation for location services.
  function generateLocationManagerCode(accuracy: string, geofencing: any, capture: any, permissions: any): string { return ` \`\`\`kotlin @Singleton class DHIS2LocationManager @Inject constructor( @ApplicationContext private val context: Context ) { private val fusedLocationClient = LocationServices.getFusedLocationProviderClient(context) private val locationRequest = createLocationRequest() private fun createLocationRequest(): LocationRequest { return LocationRequest.Builder( Priority.${getLocationPriority(accuracy)}, ${capture.timeoutSeconds ? capture.timeoutSeconds * 1000 : 10000}L // ${capture.timeoutSeconds || 10} seconds ).apply { setWaitForAccurateLocation(${capture.validation || false}) ${capture.accuracyThreshold ? `setMinUpdateDistanceMeters(${capture.accuracyThreshold}f)` : ''} }.build() } suspend fun getCurrentLocation(): Location { return withContext(Dispatchers.IO) { suspendCancellableCoroutine { continuation -> if (!hasLocationPermission()) { continuation.resumeWithException(SecurityException("Location permission not granted")) return@suspendCancellableCoroutine } fusedLocationClient.getCurrentLocation( Priority.${getLocationPriority(accuracy)}, null ).addOnSuccessListener { location -> if (location != null) { ${capture.validation ? 'if (isLocationAccurate(location)) {' : ''} continuation.resume(location) ${capture.validation ? '} else { continuation.resumeWithException(Exception("Location accuracy insufficient")) }' : ''} } else { continuation.resumeWithException(Exception("Unable to get location")) } }.addOnFailureListener { exception -> continuation.resumeWithException(exception) } } } } ${capture.validation ? ` private fun isLocationAccurate(location: Location): Boolean { return location.accuracy <= ${capture.accuracyThreshold || 10}f }` : ''} fun hasLocationPermission(): Boolean { return ContextCompat.checkSelfPermission( context, Manifest.permission.ACCESS_FINE_LOCATION ) == PackageManager.PERMISSION_GRANTED } fun requestPermissions(activity: Activity) { val requestPermissions = mutableListOf<String>() ${permissions.fineLocation ? 'requestPermissions.add(Manifest.permission.ACCESS_FINE_LOCATION)' : ''} ${permissions.coarseLocation ? 'requestPermissions.add(Manifest.permission.ACCESS_COARSE_LOCATION)' : ''} ${permissions.backgroundLocation ? 'requestPermissions.add(Manifest.permission.ACCESS_BACKGROUND_LOCATION)' : ''} ActivityCompat.requestPermissions( activity, requestPermissions.toTypedArray(), LOCATION_PERMISSION_REQUEST_CODE ) } companion object { private const val LOCATION_PERMISSION_REQUEST_CODE = 1001 } } \`\`\``;